Write-Output
将指定对象发送到管道中的下一个命令。如果该命令是管道中的最后一个命令,则在控制台上显示这些对象。
语法
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 类的成员,从而表明沿着管道传递了该字符串。
另请参阅
概念
Write-Debug
Write-Verbose
Write-Error
Write-Progress
Write-Host
Write-Warning
Tee-Object