Disable-PSBreakpoint
關閉目前控制台的斷點。
語法
Breakpoint (預設值)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Disable-PSBreakpoint指令長會停用斷點，確保腳本執行時斷點不會被觸發。 你可以用它來停用所有斷點，或者透過提交斷點物件或斷點 ID 來指定斷點。
技術上來說，這個 cmdlet 會將斷點物件的 Enabled 屬性值改為 False。
要重新啟用斷點，請使用 Enable-PSBreakpoint cmdlet。 使用 Set-PSBreakpoint 指令檔建立斷點時預設是啟用的。
中斷點是腳本中執行暫時停止的一個點，讓你能檢視腳本中的指令。
Disable-PSBreakpoint 是多個為除錯 PowerShell 腳本設計的 cmdlet 之一。 如需 PowerShell 調試程式的詳細資訊，請參閱 about_Debuggers。
範例
範例 1：設定斷點並停用它
這些指令會使新建立的斷點失效。
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
Set-PSBreakpoint指令本在腳本中為變數Sample.ps1建立斷點$Name，並將斷點物件保存在變$B數中。
Disable-PSBreakpoint指令小說會停用新的斷點。 它使用管線運算子（|）將斷點物件 $B 傳送到 Disable-PSBreakpoint cmdlet。
因此，斷$B點物件的 Enabled 屬性值為 False。
範例 2：停用斷點
此指令會停用斷點 ID 為 0 的斷點。
Disable-PSBreakpoint -Id 0
範例 3：建立一個停用的中斷點
這個指令會建立一個新的斷點，直到你啟用它為止，這個斷點會被停用。
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
它使用 Disable-PSBreakpoint cmdlet 來停用斷點。
Breakpoint 參數的值是一個Set-PSBreakpoint指令，可以設定新的斷點、產生斷點物件，並將該物件儲存在變數中$B。
以物件為值的指令長參數可以接受包含物件的變數，或是取得或產生物件的指令。 在這種情況下，因為 Set-PSBreakpoint 產生一個斷點物件，它可以作為 斷點 參數的值。
範例 4：停用目前主控台中的所有中斷點
此指令會禁用目前主控台中的所有斷點。
`Get-PSBreakpoint` | Disable-PSBreakpoint
範例 5：在跑道空間中停用斷點
在此範例中，工作啟動後，執行時設定中斷點為中斷 Set-PSBreakpoint 。 Runspace 會儲存在變數中，並使用 Get-PSBreakpoint 參數傳遞至 命令。
Get-PSBreakpoint輸出 會被 pipe 輸出到 ，Disable-PSBreakpoint以使跑道空間中的斷點失效。
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakpoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace
參數
-Breakpoint
指定要停用的斷點。 輸入包含斷點物件的變數，或是取得斷點物件的指令，例如 Get-PSBreakpoint 指令。 你也可以把斷點物件管道接到 Disable-PSBreakpoint cmdlet。
參數屬性
| 類型: | |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Breakpoint
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
禁用指定斷點 ID 的斷點。 輸入 ID 或包含這些 ID 的變數。 你無法將 ID 管道傳送到 Disable-PSBreakpoint。
參數屬性
| 類型: | Int32[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Id
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PassThru
回傳一個代表啟用斷點的物件。 根據預設，此 Cmdlet 不會產生任何輸出。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Runspace
指定 Runspace 物件的識別符，讓您可以在指定的 runspace 中與斷點互動。
此參數已在PowerShell 7.2中新增。
參數屬性
| 類型: | Runspace |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | RunspaceID |
參數集
Id
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Breakpoint
你可以把斷點物件管線到這個 cmdlet。
輸出
None
根據預設，此 Cmdlet 不會傳回任何輸出。
Breakpoint
當你使用 PassThru 參數時，這個 cmdlet 會回傳一個代表被停用斷點的斷點物件。
備註
PowerShell 包含下列 Disable-PSBreakpoint的別名：
- 所有平臺：
dbp
