關於輸出數據流
簡短描述
說明 PowerShell 中輸出資料流的可用性和用途。
完整描述
PowerShell 提供多個輸出數據流。 數據流會為不同類型的訊息提供通道。 您可以使用相關聯的 Cmdlet 或重新導向來寫入這些數據流。 如需詳細資訊,請參閱 about_Redirection。
PowerShell 支援下列輸出數據流。
Stream# | Description | 於 | 寫入 Cmdlet |
---|---|---|---|
1 | 成功 串流 | PowerShell 2.0 | Write-Output |
2 | 錯誤 數據流 | PowerShell 2.0 | Write-Error |
3 | 警告 數據流 | PowerShell 3.0 | Write-Warning |
4 | 詳細信息 數據流 | PowerShell 3.0 | Write-Verbose |
5 | 偵 錯數據流 | PowerShell 3.0 | Write-Debug |
6 | 信息 數據流 | PowerShell 5.0 | Write-Information |
n/a | 進度 數據流 | PowerShell 3.0 | Write-Progress |
注意
進度數據流不支援重新導向。
成功串流
成功數據流是一般、成功結果的預設數據流。
Write-Output
使用 Cmdlet 明確地將物件寫入此數據流。 此數據流用於透過PowerShell管線傳遞物件。 成功數據流會連線到原生應用程式的 stdout 數據流。
錯誤數據流
Error 數據流是錯誤結果的預設數據流。 Write-Error
使用 Cmdlet 明確寫入此數據流。 Error 數據流會連線到原生應用程式的 stderr 數據流。 在大部分情況下,這些錯誤可能會終止執行管線。 寫入此數據流的錯誤也會新增 $Error
自動變數。 如需詳細資訊,請參閱 about_Automatic_Variables。
警告數據流
Warning 資料流適用於錯誤狀況,其嚴重性低於寫入錯誤數據流的錯誤。 在正常情況下,這些警告不會終止執行。 警告不會寫入自動 $Error
變數。 Write-Warning
使用 Cmdlet 明確寫入此數據流。
詳細資訊資料流
詳細資訊數據流適用於協助使用者以互動方式或從腳本執行命令時進行疑難解答的訊息。 Write-Verbose
使用 Cmdlet 明確地將訊息寫入此數據流。 許多 Cmdlet 都提供詳細資訊輸出,有助於瞭解 Cmdlet 的內部運作。 只有在您使用一般參數時, -Verbose
才會輸出詳細資訊訊息。 如需詳細資訊,請參閱 about_CommonParameters。
偵錯資料流
偵錯數據流用於協助腳本者瞭解其程式代碼失敗的原因的訊息。 Write-Debug
使用 Cmdlet 明確寫入此數據流。 只有在您使用一般參數時, -Debug
偵錯訊息才會輸出。 如需詳細資訊,請參閱 about_CommonParameters。
偵錯訊息適用於比終端使用者更多的腳本和 Cmdlet 開發人員。 這些偵錯訊息可以包含深層疑難解答所需的內部詳細數據。
信息數據流
信息數據流旨在提供訊息,協助使用者瞭解腳本的用途。 開發人員也可以使用它做為透過PowerShell傳遞資訊的額外數據流。 開發人員可以標記數據流數據,並具有該數據流的特定處理。 Write-Information
使用 Cmdlet 明確寫入此數據流。
進度數據流
進度數據流用於在較長執行的命令和腳本中通訊進度的訊息。 Write-Progress
使用 Cmdlet 明確地將訊息寫入此數據流。 進度數據流不支援重新導向。