從目前主控台刪除中斷點。
語法
Remove-PSBreakpoint [-Id] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>] Remove-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-Confirm] [-WhatIf] [<CommonParameters>]
描述
Remove-PSBreakpoint Cmdlet 會刪除中斷點。請輸入中斷點物件或中斷點識別碼。
移除中斷點後，中斷點物件不再可用或無效。如果已經將中斷點物件儲存在變數中，則參考仍存在，但中斷點無效。
Remove-PSBreakpoint 是其中幾個專為偵錯 Windows PowerShell 指令碼所設計的 Cmdlet。如需 Windows PowerShell 偵錯工具的詳細資訊，請參閱 about_Debuggers。
參數
-Breakpoint <Breakpoint[]>
指定要刪除的中斷點。請輸入包含中斷點物件的變數或可取得中斷點物件的命令，例如 Get-PSBreakpoint 命令。您也可經由管道將中斷點物件輸出至 Remove-PSBreakpoint。
|
必要? |
true |
|
位置? |
1 |
|
預設值 |
無 |
|
接受管線輸入? |
true (ByValue) |
|
接受萬用字元? |
false |
-Id <Int32[]>
刪除有指定的中斷點識別碼的中斷點。
|
必要? |
true |
|
位置? |
1 |
|
預設值 |
無 |
|
接受管線輸入? |
true (ByPropertyName) |
|
接受萬用字元? |
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 您可經由管道將中斷點物件輸出至 Remove-PSBreakpoint。 |
|
輸出 |
無 這個 Cmdlet 不會產生任何輸出。 |
範例 1
C:\PS>get-breakpoint | remove-breakpoint 描述 ----------- 這個命令會刪除目前主控台中的所有中斷點。
範例 2
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name C:\PS> $b | remove-psbreakpoint 描述 ----------- 這個命令會刪除中斷點。 第一個命令會使用 Set-PSBreakpoint Cmdlet 在 Sample.ps1 指令碼的 Name 變數上建立中斷點，然後將中斷點物件儲存到 $b 變數。 第二個命令會使用 Remove-PSBreakpoint Cmdlet 刪除新的中斷點，並使用管線運算子 (|) 將 $b 變數中的中斷點物件傳送給 Remove-PSBreakpoint Cmdlet。 因為這個命令，如果您執行指令碼，它會執行到完成而不停止。而且，Get-PSBreakpoint Cmdlet 也不會傳回這個中斷點。
範例 3
C:\PS>remove-psbreakpoint -id 2 描述 ----------- 這個命令會刪除中斷點識別碼為 2 的中斷點。
範例 4
C:\PS>function del-psb { get-psbreakpoint | remove-psbreakpoint }
描述
-----------
這個簡單函數會刪除目前主控台中的所有中斷點。它會使用 Get-PSBreakpoint Cmdlet 取得中斷點，然後使用管線運算子 (|) 將中斷點傳送給 Remove-PSBreakpoint Cmdlet，讓後者刪除中斷點。
因此，您可以輸入 "del-psb" 來代替較長的命令。
若要儲存這個函數，請將它新增到 Windows PowerShell 設定檔。
請參閱