Skip to content

Commit 2c0fc87

Browse files
Clarify experimental feature is mainstream
Previous verbiage in about_Pipelines wasn't clear that PSNativeCommandPreserveBytePipe is mainstream in PS 7.4.
1 parent 4a6a36f commit 2c0fc87

3 files changed

Lines changed: 27 additions & 33 deletions

File tree

reference/7.4/Microsoft.PowerShell.Core/About/about_Pipelines.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Combining commands into pipelines in the PowerShell
33
Locale: en-US
4-
ms.date: 10/02/2025
4+
ms.date: 12/28/2025
55
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_pipelines?view=powershell-7.4&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_Pipelines
@@ -400,17 +400,15 @@ one at a time.
400400
## Using native commands in the pipeline
401401

402402
PowerShell allows you to include native external commands in the pipeline.
403-
However, it's important to note that PowerShell's pipeline is object-oriented
404-
and doesn't support raw byte data.
405403

406-
Piping or redirecting output from a native program that outputs raw byte data
407-
converts the output to .NET strings. This conversion can cause corruption of
408-
the raw data output.
404+
Before PowerShell 7.4, piping or redirecting output from a native program that
405+
outputs raw byte data converted the output to .NET strings. This conversion
406+
caused corruption of the raw data output.
409407

410-
However, PowerShell 7.4 added the `PSNativeCommandPreserveBytePipe`
411-
experimental feature that preserves byte-stream data when redirecting the
412-
**stdout** stream of a native command to a file or when piping byte-stream data
413-
to the **stdin** stream of a native command.
408+
In PowerShell 7.4 or higher, the `PSNativeCommandPreserveBytePipe` experimental
409+
feature is mainstream. This feature preserves byte-stream data when
410+
redirecting the **stdout** stream of a native command to a file or when piping
411+
byte-stream data to the **stdin** stream of a native command.
414412

415413
For example, using the native command `curl` you can download a binary file and
416414
save it to disk using redirection.
@@ -616,7 +614,7 @@ Get-Process | Where-Object CPU | Where-Object Path
616614
```
617615

618616
> [!IMPORTANT]
619-
> When working interactively in the shell, pasting code with pipelines at the
617+
> When working interactively in the shell, paste code with pipelines at the
620618
> beginning of a line only when using <kbd>Ctrl</kbd>+<kbd>V</kbd> to paste.
621619
> Right-click paste operations insert the lines one at a time. Since the line
622620
> doesn't end with a pipeline character, PowerShell considers the input to be

reference/7.5/Microsoft.PowerShell.Core/About/about_Pipelines.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Combining commands into pipelines in the PowerShell
33
Locale: en-US
4-
ms.date: 10/02/2025
4+
ms.date: 12/28/2025
55
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_pipelines?view=powershell-7.5&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_Pipelines
@@ -400,17 +400,15 @@ one at a time.
400400
## Using native commands in the pipeline
401401

402402
PowerShell allows you to include native external commands in the pipeline.
403-
However, it's important to note that PowerShell's pipeline is object-oriented
404-
and doesn't support raw byte data.
405403

406-
Piping or redirecting output from a native program that outputs raw byte data
407-
converts the output to .NET strings. This conversion can cause corruption of
408-
the raw data output.
404+
Before PowerShell 7.4, piping or redirecting output from a native program that
405+
outputs raw byte data converted the output to .NET strings. This conversion
406+
caused corruption of the raw data output.
409407

410-
However, PowerShell 7.4 added the `PSNativeCommandPreserveBytePipe`
411-
experimental feature that preserves byte-stream data when redirecting the
412-
**stdout** stream of a native command to a file or when piping byte-stream data
413-
to the **stdin** stream of a native command.
408+
In PowerShell 7.4 or higher, the `PSNativeCommandPreserveBytePipe` experimental
409+
feature is mainstream. This feature preserves byte-stream data when
410+
redirecting the **stdout** stream of a native command to a file or when piping
411+
byte-stream data to the **stdin** stream of a native command.
414412

415413
For example, using the native command `curl` you can download a binary file and
416414
save it to disk using redirection.
@@ -616,7 +614,7 @@ Get-Process | Where-Object CPU | Where-Object Path
616614
```
617615

618616
> [!IMPORTANT]
619-
> When working interactively in the shell, pasting code with pipelines at the
617+
> When working interactively in the shell, paste code with pipelines at the
620618
> beginning of a line only when using <kbd>Ctrl</kbd>+<kbd>V</kbd> to paste.
621619
> Right-click paste operations insert the lines one at a time. Since the line
622620
> doesn't end with a pipeline character, PowerShell considers the input to be

reference/7.6/Microsoft.PowerShell.Core/About/about_Pipelines.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Combining commands into pipelines in the PowerShell
33
Locale: en-US
4-
ms.date: 10/02/2025
4+
ms.date: 12/28/2025
55
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_pipelines?view=powershell-7.6&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_Pipelines
@@ -400,17 +400,15 @@ one at a time.
400400
## Using native commands in the pipeline
401401

402402
PowerShell allows you to include native external commands in the pipeline.
403-
However, it's important to note that PowerShell's pipeline is object-oriented
404-
and doesn't support raw byte data.
405403

406-
Piping or redirecting output from a native program that outputs raw byte data
407-
converts the output to .NET strings. This conversion can cause corruption of
408-
the raw data output.
404+
Before PowerShell 7.4, piping or redirecting output from a native program that
405+
outputs raw byte data converted the output to .NET strings. This conversion
406+
caused corruption of the raw data output.
409407

410-
However, PowerShell 7.4 added the `PSNativeCommandPreserveBytePipe`
411-
experimental feature that preserves byte-stream data when redirecting the
412-
**stdout** stream of a native command to a file or when piping byte-stream data
413-
to the **stdin** stream of a native command.
408+
In PowerShell 7.4 or higher, the `PSNativeCommandPreserveBytePipe` experimental
409+
feature is mainstream. This feature preserves byte-stream data when
410+
redirecting the **stdout** stream of a native command to a file or when piping
411+
byte-stream data to the **stdin** stream of a native command.
414412

415413
For example, using the native command `curl` you can download a binary file and
416414
save it to disk using redirection.
@@ -616,7 +614,7 @@ Get-Process | Where-Object CPU | Where-Object Path
616614
```
617615

618616
> [!IMPORTANT]
619-
> When working interactively in the shell, pasting code with pipelines at the
617+
> When working interactively in the shell, paste code with pipelines at the
620618
> beginning of a line only when using <kbd>Ctrl</kbd>+<kbd>V</kbd> to paste.
621619
> Right-click paste operations insert the lines one at a time. Since the line
622620
> doesn't end with a pipeline character, PowerShell considers the input to be

0 commit comments

Comments
 (0)