將指定的物件傳送給管線中的下一個命令。如果此命令是管線中的最後一個命令,這些物件就會顯示在主控台中。

語法

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 類別的成員,以此示範字串是沿著管線進行傳送的。






請參閱




目錄