Write-Debug

發行項
10/30/2009

將偵錯訊息寫入主控台。

語法

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。

請參閱

概念

Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning

共用方式為