将指定对象发送到管道中的下一个命令。如果该命令是管道中的最后一个命令，则在控制台上显示这些对象。

语法

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

说明

Write-Output cmdlet 将指定对象发送到管道中的下一个命令。如果该命令是管道中的最后一个命令，则会在控制台中显示该对象。

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

此 cmdlet 通常在脚本中使用以便在控制台上显示字符串和其它对象。但是，由于默认行为是在管道结束时显示对象，因此通常没必要使用该 cmdlet。例如，“get-process | write-output”与“get-process”等效。

参数

-InputObject <PSObject[]>

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

是否为必需？

true

位置？

1

默认值

是否接受管道输入？

true (ByValue)

是否接受通配符？

false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

System.Management.Automation.PSObject

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

输出

System.Management.Automation.PSObject

Write-Output 返回作为输入提交的对象。

示例 1

C:\PS>$p = get-process

c:\PS> write-output $p

c:\PS> $p

说明
-----------
这些命令获取表示计算机上所运行进程的对象，然后在控制台上显示这些对象。

示例 2

C:\PS>write-output "test output" | get-member

说明
-----------
此命令通过管道将字符串“test output”传递给 Get-Member cmdlet，后者显示 String 类的成员，从而表明沿着管道传递了该字符串。

另请参阅



目录