開啟或關閉指令碼偵錯功能、設定追蹤層級和切換嚴格模式。

語法

Set-PSDebug [-Off] [<CommonParameters>]

Set-PSDebug [-Step] [-Strict] [-Trace <int>] [<CommonParameters>]

描述

Set-PSDebug Cmdlet 會開啟或關閉指令碼偵錯功能、設定追蹤層級並切換嚴格模式。

將 Trace 參數設定為 1 時,便會在執行指令碼時追蹤每一行內容。當此參數設定為 2 時,則會同時追蹤變數指派、函數呼叫和指令碼呼叫。如果指定 Step 參數,您會在每一行指令碼執行之前收到提示。

參數

-Off

關閉所有的指令碼偵錯功能。

注意:"set-strictmode -off" 命令會停用 "set-psdebug -strict" 命令所設定的驗證。如需詳細資訊,請參閱 Set-StrictMode。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Step

開啟指令碼逐步偵錯。執行每一行之前,系統會提示使用者停止、繼續或進入新的直譯器層級,以便檢查指令碼的狀態。

注意:指定 Step 參數時,會自動將 Trace 的層級設定為 1。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Strict

指定如果尚未指定變數值就參考變數,直譯器就會擲回例外狀況。

注意:"set-strictmode -off" 命令會停用 "set-psdebug -strict" 命令所設定的驗證。如需詳細資訊,請參閱 Set-StrictMode。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Trace <int>

指定追蹤層級:

0 - 關閉指令碼追蹤

1 - 執行指令碼時追蹤其各行內容

2 - 追蹤指令碼行、變數指派、函數呼叫以及指令碼。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

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

輸入和輸出

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

輸入

None

您無法經由管道將輸入輸出至這個 Cmdlet。

輸出

None

這個 Cmdlet 不會傳回任何輸出。

範例 1

C:\PS>set-psdebug -trace 2; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
1
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
2
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
3

描述
-----------
這個命令會將追蹤層級設定為 2,然後執行會顯示 1、2 和 3 等數字的指令碼。






範例 2

C:\PS>set-psdebug -step; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
Continue with this operation?
   1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help
(default is "Y"):a
DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
1
2
3

描述
-----------
這個命令會啟動逐步偵錯,然後
執行會顯示 1、2 和 3 等數字的指令碼。






範例 3

C:\PS>set-psdebug -off; foreach ($i in 1..3) {$i}

1
2
3

描述
-----------
這個命令會關閉所有偵錯功能,然後執行會顯示 1、2 和 3 等數字的指令碼。






範例 4

C:\PS>set-psdebug -strict; $NewVar

The variable $NewVar cannot be retrieved because it has not been set yet.
At line:1 char:28
+ Set-PsDebug -strict;$NewVar <<<<

描述
-----------
這個命令會將直譯器設定為嚴格模式,並嘗試存取尚未設定的變數。






請參閱




目錄