Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

(GH-9039) Document ordered hash table for ConvertFrom-Json #9042

Merged

Conversation

michaeltlombardi
Copy link
Contributor

@michaeltlombardi michaeltlombardi commented Jul 19, 2022

PR Summary

Prior to this change, the ConvertFrom-Json cmdlet returnedd a Hashtable object when used with the AsHashtable parameter. Starting with PowerShell 7.3, it instead returns an OrderedHashtable object.

This change:

PR Checklist

  • Descriptive Title: This PR's title is a synopsis of the changes it proposes.
  • Summary: This PR's summary describes the scope and intent of the change.
  • Contributor's Guide: I have read the contributors guide.
  • Style: This PR adheres to the style guide.

@opbld30
Copy link

opbld30 commented Jul 19, 2022

Docs Build status updates of commit 587ecfd:

✅ Validation status: passed

File Status Preview URL Details
reference/7.3/Microsoft.PowerShell.Utility/ConvertFrom-Json.md ✅Succeeded View (powershell-7.3)

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

Prior to this change, the `ConvertFrom-Json` cmdlet returnedd a
**Hashtable** object when used with the **AsHashtable** parameter.
Starting with PowerShell 7.3, it instead returns an **OrderedHashtable**
object.

This change:

- Modifies the output type and parameter documentation to reflect the
  updated object type for 7.3.
- Updates the parameter documentation for 7.0+ to better reflect the
  reasons to use the **AsHashtable** parameter.
- Resolves MicrosoftDocs#9039
- Fixes AB#4440
@michaeltlombardi michaeltlombardi force-pushed the GH-9039/main/convertfrom-json branch from 587ecfd to af70c93 Compare July 19, 2022 18:23
@opbld32
Copy link

opbld32 commented Jul 19, 2022

Docs Build status updates of commit af70c93:

✅ Validation status: passed

File Status Preview URL Details
reference/7.0/Microsoft.PowerShell.Utility/ConvertFrom-Json.md ✅Succeeded View (powershell-7)
reference/7.2/Microsoft.PowerShell.Utility/ConvertFrom-Json.md ✅Succeeded View (powershell-7.2)
reference/7.3/Microsoft.PowerShell.Utility/ConvertFrom-Json.md ✅Succeeded View (powershell-7.3)

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

ConvertFrom-Json -AsHashtable now uses ordered hashtable
4 participants