共用方式為


Write-Debug

將偵錯訊息寫入主控台。

語法

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

Description

Cmdlet Write-Debug 會從腳本或命令將偵錯訊息寫入主機。

根據預設,偵錯訊息不會顯示在控制台中,但您可以使用Debug參數或$DebugPreference變數來顯示它們

範例

範例 1:瞭解$DebugPreference

此範例會寫入偵錯訊息。

Write-Debug "Cannot open file."

的預設值 $DebugPreferenceSilentlyContinue。 因此,訊息不會顯示在控制台中。

範例 2:變更 $DebugPreference 的值

這個範例顯示變更變數值 $DebugPreference 的效果。 首先,我們會顯示 的目前值 $DebugPreference ,並嘗試寫入偵錯訊息。 然後,我們將的值 $DebugPreference 變更為 [繼續],以允許顯示偵錯訊息。

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

請注意,當您使用Debug參數時,變更$DebugPreference的值。 這項變更只會影響函式的範圍。 值不會在函式外部受到影響。

如需偵錯一般參數的詳細資訊,請參閱 about_CommonParameters

參數

-Message

指定要傳送至主控台的偵錯訊息。

類型:String
別名:Msg
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

String

您可以使用管線將包含偵錯訊息的字串傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。 它只會寫入偵錯數據流。