次の方法で共有

Write-Verbose

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

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

構文

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

説明

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

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

例

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

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

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

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

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

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

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

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

パラメーター

-Message

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

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

String

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

出力

None

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

メモ

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