次の方法で共有

Write-Debug

モジュール:
Microsoft.PowerShell.Utility Module

デバッグ メッセージをコンソールに書き込みます。

構文

Default (既定) 

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

説明

Write-Debug コマンドレットは、スクリプトまたはコマンドからホストにデバッグ メッセージを書き込みます。

既定では、デバッグ メッセージはコンソールに表示されませんが、Debug パラメーターまたは $DebugPreference 変数を使用して表示できます。

例

例 1: $DebugPreferenceについて

この例では、デバッグ メッセージを書き込みます。

Write-Debug "Cannot open file."

の既定値は、SilentlyContinueです。 そのため、メッセージはコンソールに表示されません。

例 2: $DebugPreferenceの値を変更する

この例では、$DebugPreference 変数の値を変更した場合の効果を示します。 まず、$DebugPreference の現在の値を表示し、デバッグ メッセージを書き込もうとします。 次に、$DebugPreference の値を Continueに変更します。これにより、デバッグ メッセージを表示できます。

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

$DebugPreferenceの詳細については、「about_Preference_Variables」を参照してください。

例 3: Debug パラメーターを使用して$DebugPreferenceをオーバーライドする

Test-Debug 関数は、$DebugPreference 変数の値を PowerShell ホストとデバッグ ストリームに書き込みます。 この例では、Debug パラメーターを使用して、$DebugPreference 値をオーバーライドします。

function Test-Debug {
    [CmdletBinding()]
    param()
    Write-Debug ('$DebugPreference is ' + $DebugPreference)
    Write-Host ('$DebugPreference is ' + $DebugPreference)
}

PS> Test-Debug
$DebugPreference is SilentlyContinue

PS> Test-Debug -Debug
DEBUG: $DebugPreference is Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue

$DebugPreference パラメーターを使用すると、 の値が変わります。 この変更は、関数のスコープにのみ影響します。 この値は関数の外部には影響しません。

デバッグ 共通パラメーターの詳細については、「about_CommonParameters」を参照してください。

パラメーター

-Message

コンソールに送信するデバッグ メッセージを指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:メッセージ

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

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

出力

None

このコマンドレットは出力を返しません。 デバッグ ストリームにのみ書き込まれます。