フィードバック

about_Output_Streams

  • [アーティクル]

簡単な説明

PowerShell での出力ストリームの可用性と目的について説明します。

長い説明

PowerShell では、複数の出力ストリームが提供されます。 ストリームは、さまざまな種類のメッセージのチャネルを提供します。 関連付けられたコマンドレットまたはリダイレクトを使用して、これらのストリームに書き込みます。 詳細については、「about_Redirection」 を参照してください。

PowerShell では、次の出力ストリームがサポートされています。

ストリーム# 説明 で導入されました Write コマンドレット
1 成功 ストリーム PowerShell 2.0 Write-Output
2 エラー ストリーム PowerShell 2.0 Write-Error
3 警告 ストリーム PowerShell 2.0 Write-Warning
4 詳細 ストリーム PowerShell 2.0 Write-Verbose
5 デバッグ ストリーム PowerShell 2.0 Write-Debug
6 情報 ストリーム PowerShell 5.0 Write-Information
該当なし 進行状況 ストリーム PowerShell 2.0 Write-Progress

注意

Progress ストリーム ではリダイレクトはサポートされていません。

成功ストリーム

成功 ストリームは 、通常の成功した結果の既定のストリームです。 このストリームに Write-Output オブジェクトを明示的に書き込むには、 コマンドレットを使用します。 このストリームは、PowerShell パイプラインを介してオブジェクトを渡す場合に使用されます。 成功 ストリーム は、ネイティブ アプリケーション の stdout ストリームに接続されます。

エラー ストリーム

エラー ストリーム は、エラー結果の既定のストリームです。 コマンドレットを使用 Write-Error して、このストリームに明示的に書き込みます。 エラー ストリーム は、ネイティブ アプリケーション の stderr ストリームに接続されています。 ほとんどの条件下では、これらのエラーによって実行パイプラインが終了する可能性があります。 このストリームに書き込まれたエラーは、自動変数も $Error 追加されます。 詳細については、「about_Automatic_Variables」を参照してください。

警告ストリーム

警告 ストリーム は、エラー ストリームに書き込まれたエラーよりも重大なエラー状態を 対象 にしています。 通常の条件下では、これらの警告は実行を終了しません。 警告は自動変数に書き $Error 込まれます。 コマンドレットを使用 Write-Warning して、このストリームに明示的に書き込みます。

詳細ストリーム

詳細 ストリーム は、ユーザーが対話形式またはスクリプトから実行されるコマンドのトラブルシューティングに役立つメッセージを対象にしています。 このストリームに Write-Verbose メッセージを明示的に書き込むには、 コマンドレットを使用します。 多くのコマンドレットは、コマンドレットの内部動作を理解するために役立つ詳細な出力を提供します。 詳細メッセージは、共通パラメーターを使用する場合にのみ -Verbose 出力されます。 詳細については、「about_CommonParameters」を参照してください。

デバッグ ストリーム

デバッグ ストリーム は、スクリプターがコードが失敗する理由を理解するのに役立つメッセージに使用されます。 コマンドレットを使用 Write-Debug して、このストリームに明示的に書き込みます。 デバッグ メッセージは、共通パラメーターを使用する場合にのみ -Debug 出力されます。 詳細については、「about_CommonParameters」を参照してください。

デバッグ メッセージは、エンド ユーザーよりもスクリプトとコマンドレットの開発者を対象にしています。 これらのデバッグ メッセージには、詳細なトラブルシューティングに必要な内部の詳細を含めできます。

情報ストリーム

情報 ストリーム は、スクリプトの動作をユーザーが理解するのに役立つメッセージを提供することを目的としています。 また、開発者は、PowerShell を介して情報を渡す追加のストリームとして使用できます。 開発者は、ストリーム データにタグを付け、そのストリームに固有の処理を行います。 コマンドレットを使用 Write-Information して、このストリームに明示的に書き込みます。

進行状況ストリーム

Progress ストリーム は、実行時間の長いコマンドとスクリプトの進行状況を伝えるメッセージに使用されます。 このストリームに Write-Progress メッセージを明示的に書き込むには、 コマンドレットを使用します。 Progress ストリーム ではリダイレクトはサポートされていません。

関連項目