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

構文

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

説明

Write-Verbose コマンドレットは、テキストを Windows PowerShell の詳細メッセージ ストリームに書き込みます。通常、詳細メッセージ ストリームを使用して、コマンドのデバッグに使用されるコマンド処理に関する情報を送付します。

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

パラメーター

-Message <string>

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

必須

true

位置

1

既定値

パイプライン入力を許可する

true (ByValue)

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

System.String

パイプを使用してメッセージを含む文字列を Write-Verbose に渡すことができます。

出力

なし

Write-Verbose は、詳細メッセージ ストリームに対してのみ書き込みを行います。

例 1

C:\PS>Write-Verbose -message "Searching the Application Event Log."

C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose

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

2 番目のコマンドでは、Verbose 共通パラメーターが使用されています。これにより、$VerbosePreference 変数の値とは無関係に、詳細メッセージが表示されます。






例 2

C:\PS>$VerbosePreference = "Continue"

C:\PS> Write-Verbose "Copying file $filename"

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

1 番目のコマンドは、"Continue" の値を $VerbosePreference ユーザー設定変数に代入します。既定値の "SilentlyContinue" は、詳細メッセージを抑止します。

2 番目のコマンドは詳細メッセージを書き込みます。






関連項目




目次