Disable-PSBreakpoint
停用目前控制台中的斷點。
語法
Breakpoint (預設值)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Disable-PSBreakpoint Cmdlet 會停用斷點，以確保腳本執行時不會叫用這些斷點。 您可以使用它來停用所有斷點，也可以藉由提交斷點對象或斷點標識碼來指定斷點。
從技術上看，此 Cmdlet 會將斷點物件的 Enabled 屬性值變更為 False。
若要重新啟用斷點，請使用 Enable-PSBreakpoint Cmdlet。 當您使用 Set-PSBreakpoint Cmdlet 建立斷點時，預設會啟用斷點。
斷點是腳本中的一個點，執行會暫時停止，讓您可以檢查腳本中的指示。
Disable-PSBreakpoint 是數個專為偵錯 PowerShell 腳本而設計的 Cmdlet 之一。 如需 PowerShell 調試程式的詳細資訊，請參閱 about_Debuggers。
範例
範例 1：設定斷點並加以停用
這些命令會停用新建立的斷點。
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
Set-PSBreakpoint Cmdlet 會在 $Name 腳本中的 Sample.ps1 變數上建立斷點，並將斷點物件儲存在 $B 變數中。
Disable-PSBreakpoint Cmdlet 會停用新的斷點。 它會使用管線運算符 （|） 將 $B 中的斷點物件傳送至 Disable-PSBreakpoint Cmdlet。
由於此指令， 中斷點物件的 $B 屬性值 False。
範例 2：停用斷點
此命令會停用斷點標識碼為 0 的斷點。
Disable-PSBreakpoint -Id 0
範例 3：建立停用的斷點
此命令會建立停用的新斷點，直到您啟用為止。
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
它會使用 Disable-PSBreakpoint Cmdlet 來停用斷點。
斷點 參數的值是 Set-PSBreakpoint 命令，可設定新的斷點、產生斷點物件，並將物件儲存在 $B 變數中。
接受物件做為其值的 Cmdlet 參數可以接受包含 物件的變數，或取得或產生物件的命令。 在此情況下，因為 Set-PSBreakpoint 會產生斷點物件，所以它可以當做斷點 參數 的值使用。
範例 4：停用目前控制台中的所有斷點
此命令會停用目前控制台中的所有斷點。
`Get-PSBreakpoint` | Disable-PSBreakpoint
參數
-Breakpoint
指定要停用的斷點。 輸入包含斷點物件的變數，或取得斷點物件的命令，例如 Get-PSBreakpoint 命令。 您也可以使用管線將斷點對象傳送至 Disable-PSBreakpoint Cmdlet。
參數屬性
| 類型: | |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Breakpoint
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-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 |
-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
您可以使用管線將斷點物件傳送至 Disable-PSBreakpoint。
輸出
None or System.Management.Automation.Breakpoint
使用 PassThru 參數時， Disable-PSBreakpoint 返回表示禁用斷點的物件。 否則，此 Cmdlet 不會產生任何輸出。