共用方式為


Remove-PSBreakpoint

從目前的主控台刪除斷點。

語法

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSBreakpoint
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdlet 會 Remove-PSBreakpoint 刪除斷點。 輸入斷點對象或斷點標識碼。

當您移除斷點時,斷點對象將無法再使用或運作。 如果您已將斷點物件儲存在變數中,則參考仍然存在,但斷點無法運作。

Remove-PSBreakpoint 是數個專為偵錯 PowerShell 腳本而設計的 Cmdlet 之一。 如需 PowerShell 調試程式的詳細資訊,請參閱 about_Debuggers

範例

範例 1:移除所有斷點

此命令會刪除目前控制台中的所有斷點。

Get-PSBreakpoint | Remove-PSBreakpoint

範例 2:移除指定的斷點

此命令會刪除斷點。

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint

Cmdlet 會在Set-PSBreakpoint腳本中的Sample.ps1變數上$Name建立斷點,並將斷點物件儲存在變數中$B。 Cmdlet Remove-PSBreakpoint 會刪除新的斷點。 它會使用管線運算符 (|) 將變數中的 $B 斷點對象傳送至 Remove-PSBreakpoint Cmdlet。

由於此命令,如果您執行腳本,它會在不停止的情況下執行至完成。 此外, Get-PSBreakpoint Cmdlet 不會傳回這個斷點。

範例 3:依標識符移除斷點

此命令會刪除具有斷點標識碼 2 的斷點。

Remove-PSBreakpoint -Id 2

範例 4:使用函式移除所有斷點

這個簡單函式會刪除目前會話中的所有斷點。

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

它會使用 Get-PSBreakpoint Cmdlet 來取得斷點。 然後,它會使用管線運算符 (|) 將斷點傳送至 Remove-PSBreakpoint Cmdlet,以刪除它們。

範例 5:移除 Runspace 中的斷點

在此範例中,會啟動作業,並在執行 時 Set-PSBreakPoint 將斷點設定為中斷。 Runspace 會儲存在變數中,並使用 Runspace 參數傳遞至 Get-PSBreakPoint 命令。 的輸出 Get-PSBreakPoint 會透過管道傳送至 Remove-PSBreakpoint ,以移除 Runspace 中的斷點。

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Remove-Breakpoint -Runspace $runspace

參數

-Breakpoint

指定要刪除的斷點。 輸入包含斷點物件的變數,或取得斷點物件的命令,例如 Get-PSBreakpoint 命令。 您也可以使用管線將斷點物件傳送至 Remove-PSBreakpoint

類型:Breakpoint[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定這個 Cmdlet 刪除斷點的斷點標識碼。

類型:Int32[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Runspace

指定 Runspace 物件的識別碼 ,讓您可以在指定的 Runspace 中與斷點互動。

此參數已在PowerShell 7.2中新增。

類型:Runspace
別名:RunspaceId
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Breakpoint[]

您可以使用管線將斷點物件傳送至此 Cmdlet。

Int32[]

Runspace

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含下列的 Remove-PSBreakpoint別名:

  • 所有平臺:
    • rbp