在目前主控台中停用中斷點。

語法

Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Disable-PSBreakpoint Cmdlet 會停用中斷點,如此可確保指令碼執行時不會點擊中斷點。您可以用它來停用所有的中斷點,或是透過送出中斷點物件或中斷點識別碼來指定中斷點。

嚴格來說,此 Cmdlet 會將中斷點物件的 Enabled 屬性值設為 False。若要重新啟用中斷點,請使用 Enable-PSBreakpoint Cmdlet。在使用 Set-PSBreakpoint Cmdlet 建立中斷點時,預設會將中斷點設為啟用。

中斷點是指令碼中的一個位置,只要指令碼執行到此處就會暫停執行,讓您可以檢查指令碼中的指令。Disable-PSBreakpoint 是其中幾個專為偵錯 Windows PowerShell 指令碼所設計的 Cmdlet。如需 Windows PowerShell 偵錯工具的詳細資訊,請參閱 about_Debuggers。

參數

-Breakpoint <Breakpoint[]>

指定要停用的中斷點。請輸入包含中斷點物件的變數或可取得中斷點物件的命令,例如 Get-PSBreakpoint 命令。您也可經由管道將中斷點物件輸出至 Disable-PSBreakpoint Cmdlet。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-Id <Int32[]>

停用有指定的中斷點識別碼的中斷點。請輸入識別碼或含有識別碼的變數。您無法經由管道將識別碼輸出至 Disable-PSBreakpoint。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-PassThru

傳回代表已啟用之中斷點的物件。根據預設,此 Cmdlet 不會產生任何輸出。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

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

輸入和輸出

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

輸入

System.Management.Automation.Breakpoint

您可經由管道將中斷點物件輸出至 Disable-PSBreakpoint。

輸出

None 或 System.Management.Automation.Breakpoint

當您使用 PassThru 參數時,Disable-PSBreakpoint 會傳回代表已停用之中斷點的物件。否則,這個 Cmdlet 不會產生任何輸出。

範例 1

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name

C:\PS> $b | disable-psbreakpoint

描述
-----------
這些命令會停用新建立的中斷點。

第一個命令會使用 Set-PSBreakpoint Cmdlet 在 Sample.ps1 指令碼的 Name 變數上建立中斷點,然後將中斷點物件儲存到 $b 變數。

第二個命令會使用 Disable-PSBreakpoint Cmdlet 停用新的中斷點。並使用管線運算子 (|) 將 $b 中的中斷點物件傳送給 Disable-PSBreakpoint。

因為這個命令,$b 中的中斷點物件的 Enabled 屬性值會是 False。






範例 2

C:\PS>disable-psbreakpoint -id 0

描述
-----------
這個命令會停用中斷點識別碼為 0 的中斷點。






範例 3

C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) 

C:\PS> $b

描述
-----------
這個命令會建立新的中斷點,讓它處於停用狀態,直到您啟用它為止。

這個命令會使用 Disable-PSBreakpoint Cmdlet 停用中斷點。Breakpoint 參數的值為 Set-PSBreakpoint 命令,此命令會設定新的中斷點、產生中斷點物件,以及將該物件儲存到 $b 變數。

對於將物件當成值的 Cmdlet 參數來說,變數包含物件或是命令取得或產生物件都是可以接受的。既然這樣,Set-PSBreakpoint 就可以當成 Breakpoint 參數的值使用,因為它會產生中斷點物件。

第二個命令會顯示 $b 變數值中的中斷點物件。






範例 4

C:\PS>get-psbreakpoint | disable-psbreakpoint

描述
-----------
這個命令會在目前主控台中停用所有中斷點。您可以將這個命令縮短為:"gbp | ebp"。






請參閱




目錄