將偵錯訊息寫入主控台。

語法

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

描述

Write-Debug Cmdlet 會從指令碼或命令將偵錯訊息寫入主控台。

根據預設,主控台不會顯示偵錯訊息,但是您可以使用 Debug 參數或 $DebugPreference 變數顯示偵錯訊息。

參數

-Message <string>

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

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.String

您可經由管道將包含偵錯訊息的字串輸出至 Write-Debug。

輸出

Write-Debug 只會寫入偵錯資料流。它不會傳回任何輸出。

範例 1

C:\PS>Write-Debug "Cannot open file."

描述
-----------
這個命令會將偵錯訊息寫入主控台。$DebugPreference 的值為 "SilentlyContinue",因此主控台不顯示訊息。






範例 2

C:\PS>$DebugPreference

SilentlyContinue

C:\PS> Write-Debug "Cannot open file."
C:\PS>

C:\PS> Write-Debug "Cannot open file." -debug
DEBUG: Cannot open file.

描述
-----------
這個範例示範如何使用一般的 Debug 參數覆寫特定命令的 $DebugPreference 變數值。

第一個命令會顯示 $DebugPreference 變數的值,即預設的 "SilentlyContinue"。

第二個命令會寫入偵錯訊息,但是由於 $DebugPreference 的值,訊息不會出現。

這三個命令會寫入偵錯訊息。它會使用一般的 Debug 參數,覆寫 $DebugPreference 的值,以及顯示其所產生的偵錯訊息。

因此,即使 $DebugPreference 的值為 "SilentlyContinue",偵錯訊息還是會出現。


如需 Debug 一般參數的詳細資訊,請參閱 about_CommonParameters。






範例 3

C:\PS>$DebugPreference

SilentlyContinue

C:\PS> Write-Debug "Cannot open file."
C:\PS>

C:\PS> $DebugPreference = "Continue"

C:\PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

描述
-----------
這個命令示範 $DebugPreference 變數值在顯示偵錯訊息上的變更效果。

第一個命令會顯示 $DebugPreference 變數的值,即預設的 "SilentlyContinue"。

第二個命令會寫入偵錯訊息,但是由於 $DebugPreference 的值,訊息不會出現。

第三個命令會將 "Continue" 的值指派給 $DebugPreference 變數。

第四個命令會寫入偵錯訊息,該訊息會在主控台上顯示。

如需 $DebugPreference 的詳細資訊,請參閱 about_Preference_Variables。






請參閱




目錄