次の方法で共有


Write-Verbose

テキストを詳細メッセージ ストリームに書き込みます。

構文

Write-Verbose
     [-Message] <String>
     [<CommonParameters>]

説明

Write-Verbose コマンドレットは、PowerShell で詳細メッセージ ストリームにテキストを書き込みます。 通常、詳細メッセージ ストリームは、コマンド処理に関するより詳細な情報を提供するために使用されます。

既定では、詳細メッセージ ストリームは表示されませんが、 $VerbosePreference 変数の値を変更するか、コマンドで共通パラメーター Verbose を使用して表示できます。

例 1: ステータス メッセージを書き込む

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

これらのコマンドは、 Write-Verbose コマンドレットを使用してステータス メッセージを表示します。 既定では、メッセージは表示されません。

2 番目のコマンドでは、 Verbose 共通パラメーターを使用します。このパラメーターは、 $VerbosePreference 変数の値に関係なく、詳細メッセージを表示します。

例 2: $VerbosePreferenceを設定し、ステータス メッセージを書き込む

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

これらのコマンドは、 Write-Verbose コマンドレットを使用してステータス メッセージを表示します。 既定では、メッセージは表示されません。

最初のコマンドは、Continue の値を $VerbosePreference ユーザー設定変数に割り当てます。 既定値の SilentlyContinueは、詳細メッセージを抑制します。 2 番目のコマンドは、詳細メッセージを書き込みます。

パラメーター

-Message

表示するメッセージを指定します。 このパラメーターは必須です。 メッセージ文字列をパイプして Write-Verboseすることもできます。

型:String
Aliases:Msg
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

メッセージを含む文字列をこのコマンドレットにパイプできます。

出力

None

このコマンドレットは、出力を返しません。 詳細メッセージ ストリームにのみ書き込まれます。

メモ

  • 詳細メッセージは、コマンドが Verbose 共通パラメーターを使用する場合にのみ返されます。 詳細については、「about_CommonParameters」を参照してください。
  • Windows PowerShell バックグラウンド ジョブとリモート コマンドでは、ジョブ セッションとリモート セッションの $VerbosePreference 変数によって、詳細メッセージが既定で表示されるかどうかが決まります。 $VerbosePreference 変数の詳細については、「about_Preference_Variables」を参照してください。