about_Output_Streams
簡単な説明
PowerShell での出力ストリームの可用性と目的について説明します。
詳細な説明
PowerShell には、複数の出力ストリームが用意されています。 ストリームは、さまざまな種類のメッセージのチャネルを提供します。 関連するコマンドレットまたはリダイレクトを使用して、これらのストリームに書き込むことができます。 詳細については、about_Redirectionを参照してください。
PowerShell では、次の出力ストリームがサポートされています。
| ストリーム # | 説明 | 導入バージョン | 書き込みコマンドレット |
|---|---|---|---|
| 1 | Success 川 | PowerShell 2.0 | Write-Output |
| 2 | Error 川 | PowerShell 2.0 | Write-Error |
| 3 | Warning 川 | PowerShell 2.0 | Write-Warning |
| 4 | Verbose 川 | PowerShell 2.0 | Write-Verbose |
| 5 | Debug 川 | PowerShell 2.0 | Write-Debug |
| 6 | Information 川 | PowerShell 5.0 | Write-Information |
| 該当なし | Progress 川 | PowerShell 2.0 | Write-Progress |
Note
Progress ストリームはリダイレクトをサポートしていません。
Success 川
Success ストリームは、正常な正常な結果の既定のストリームです。
Write-Output コマンドレットを使用して、このストリームにオブジェクトを明示的に書き込みます。 このストリームは、PowerShell パイプラインを介してオブジェクトを渡すために使用されます。
Success ストリームは、ネイティブ アプリケーションのstdout ストリームに接続されます。
Error 川
Error ストリームは、エラー結果の既定のストリームです。
Write-Error コマンドレットを使用して、このストリームに明示的に書き込みます。
Error ストリームは、ネイティブ アプリケーションの stderr ストリームに接続されます。 ほとんどの条件下では、これらのエラーによって実行パイプラインが終了する可能性があります。 このストリームに書き込まれたエラーは、 $Error 自動変数にも追加されます。 詳細については、about_Automatic_Variablesを参照してください。
Warning 川
Warning ストリームは、Error ストリームに書き込まれたエラーよりも重大ではないエラー状態を対象としています。 通常の状態では、これらの警告は実行を終了しません。 警告は、 $Error 自動変数には書き込まれません。
Write-Warning コマンドレットを使用して、このストリームに明示的に書き込みます。
Verbose 川
Verbose ストリームは、対話形式またはスクリプトから実行されるコマンドのトラブルシューティングに役立つメッセージを対象としています。
Write-Verbose コマンドレットを使用して、このストリームにメッセージを明示的に書き込みます。 多くのコマンドレットは、コマンドレットの内部動作を理解するのに役立つ詳細出力を提供します。 詳細メッセージは、-Verbose 共通パラメーターを使用している場合のみ出力されます。 詳細については、about_CommonParametersを参照してください。
Debug 川
Debug ストリームは、スクリプト担当者がコードが失敗する理由を理解するのに役立つメッセージに使用されます。
Write-Debug コマンドレットを使用して、このストリームに明示的に書き込みます。 デバッグ メッセージは、-Debug 共通パラメーターを使用する場合にのみ出力されます。 詳細については、about_CommonParametersを参照してください。
Debug メッセージは、エンド ユーザー以上のスクリプトおよびコマンドレット開発者を対象としています。 これらのデバッグ メッセージには、詳細なトラブルシューティングに必要な内部の詳細を含めることができます。
Information 川
Information ストリームは、ユーザーがスクリプトの動作を理解するのに役立つメッセージを提供することを目的としています。 また、PowerShell を介して情報を渡すために使用される追加のストリームとして開発者が使用することもできます。 開発者はストリーム データにタグを付け、そのストリームに対して特定の処理を行うことができます。
Write-Information コマンドレットを使用して、このストリームに明示的に書き込みます。
Write-Host は、 Information ストリームにも書き込みます。 コマンドレットの違いは、Write-Host ストリームをリダイレクトしない限り、Informationもホスト コンソールに書き込むということです。
Write-Information は、 Information ストリームにのみ書き込みます。
Progress 川
Progress ストリームは、実行時間の長いコマンドとスクリプトの進行状況を伝えるメッセージに使用されます。
Write-Progress コマンドレットを使用して、このストリームにメッセージを明示的に書き込みます。
Progress ストリームはリダイレクトをサポートしていません。
関連項目
PowerShell