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.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

surfingoldelephant and others added 2 commits January 2, 2026 14:58
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.
@michaeltlombardi michaeltlombardi force-pushed the csvDelimiterParamDescription branch from 181f748 to afa22b4 Compare January 2, 2026 20:58
@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

This comment was marked as outdated.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit afa22b4:

✅ 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.

@michaeltlombardi michaeltlombardi merged commit 0a55ed6 into MicrosoftDocs:main Jan 2, 2026
5 checks passed
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.

2 participants