Skip to content

Conversation

@surfingoldelephant
Copy link
Contributor

@surfingoldelephant surfingoldelephant commented Dec 28, 2025

PR Summary

This PR clarifies the deserialization behavior when the specified delimiter doesn't match the actual delimiter in the input data. Before this change, the verbiage for Import/ConvertFrom-Csv -Delimiter was ambiguous, potentially suggesting output wouldn't be a custom object if the wrong delimiter is used.

In addition, this adds a note regarding special character double-quoting to all docs. Previously, the note was only present in the Import-Csv docs, but it's applicable to/useful for all CSV cmdlet -Delimiter descriptions.

There are also minor style/formatting changes.

PR Context

$output = @'
H1,H2,H3
V1,V2,V3
V1,V2,V3
'@ | ConvertFrom-Csv -Delimiter ';'

$output[0].GetType().Name
# PSCustomObject

$output[0].'H1,H2,H3'
# V1,V2,V3

This also applies to:

  • -Delimiter isn't specified and , isn't used in the input.
  • -UseCulture is specified and the delimiter used in the input doesn't match the current culture's.

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 contributor's guide.
  • Style: This PR adheres to the style guide.

This clarifies the deserialization behavior when the specified
delimiter doesn't match the actual delimiter in the input data.
Before this change, the verbiage for Import/ConvertFrom-Csv implied
one or more strings would be returned, which isn't the case.

This also adds the existing note regarding escaped special characters
to all docs. Previously, this was only present in Import-Csv docs,
but is applicable to/useful for all CSV cmdlets.
@learn-build-service-prod
Copy link
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2bf9786:

✅ Validation status: passed

File Status Preview URL Details
reference/5.1/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-5.1)
reference/7.4/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.5/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.6/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-7.6)

For more details, please refer to the build report.

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.

1 participant