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