Write-Output

参考

模块:: Microsoft.PowerShell.Utility

将指定的对象写入管道。如果 Write-Output 管道中最后一个命令，则对象将显示在控制台中。

语法

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

说明

将指定的对象写入管道。如果 Write-Output 管道中最后一个命令，则对象将显示在控制台中。

Write-Output 将对象发送到主管道，也称为“输出流”或“成功管道”。若要将错误对象发送到错误管道，请使用 Write-Error。

此 cmdlet 通常在脚本中使用，以在控制台上显示字符串和其他对象。其中 Write-Output 一个内置别名与 echo 使用 echo的其他 shell 类似。默认行为是在管道末尾显示输出。在 PowerShell 中，通常不需要在默认情况下显示输出的实例中使用 cmdlet。例如，Get-Process | Write-Output 等效于 Get-Process。或者， echo "Home directory: $HOME" 可以编写 "Home directory: $HOME"。

默认情况下， Write-Output 通过集合对象枚举。但是， Write-Output 还可用于将集合作为具有 NoEnumerate 参数的单个对象向下传递。

示例

示例 1：获取对象并将其写入控制台

在此示例中，cmdlet 的结果 Get-Process 存储在变量中 $P 。该 Write-Output cmdlet 向控制台显示进程对象 $P 。

$P = Get-Process
Write-Output $P

示例 2：将输出传递给另一个 cmdlet

此命令通过管道将“测试输出”字符串 Get-Member 传递给 cmdlet，该 cmdlet 显示 System.String 类的成员，演示该字符串沿管道传递。

Write-Output "test output" | Get-Member

示例 3：取消输出中的枚举

此命令添加 NoEnumerate 参数，以通过管道将集合或数组视为单个对象。

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

参数

-InputObject

指定要通过管道向下发送的对象。输入一个包含对象的变量，或键入可获取对象的命令或表达式。

Type:	PSObject[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoEnumerate

默认情况下， Write-Output cmdlet 始终枚举其输出。 NoEnumerate 参数禁止显示默认行为，并阻止Write-Output枚举输出。如果命令包装在括号中， 则 NoEnumerate 参数无效，因为括号强制枚举。例如， (Write-Output 1,2,3) 仍枚举数组。

NoEnumerate 参数仅在管道中有用。尝试在控制台中查看 NoEnumerate 的影响是有问题的，因为 PowerShell Out-Default 会添加到每个命令行的末尾，这会导致枚举。但是，如果通过管道 Write-Output -NoEnumerate 传递给另一个 cmdlet，下游 cmdlet 将接收集合对象，而不是集合的枚举项。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

PSObject

可以通过管道将对象传递给 Write-Output.

输出