將偵錯訊息寫入主控台。
語法
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。
請參閱