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