Remove-PSBreakpoint

Deletes breakpoints from the current console.
Remove-PSBreakpoint [-Breakpoint*] <Breakpoint[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-PSBreakpoint [-Id*] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>]

The Remove-PSBreakpoint cmdlet deletes a breakpoint. Enter a breakpoint object or a breakpoint ID.

When you remove a breakpoint, the breakpoint object is no longer available or functional. If you have saved a breakpoint object in a variable, the reference still exists, but the breakpoint does not function.

Remove-PSBreakpoint is one of several cmdlets designed for debugging Windows PowerShell scripts. For more information about the Windows PowerShell debugger, see about_Debuggers.

Parameters
-Breakpoint <Breakpoint[]>

  • This value is required
  • Default value is None
  • Accepts pipeline input ByValue

Specifies the breakpoints to delete. Enter a variable that contains breakpoint objects or a command that gets breakpoint objects, such as a Get-PSBreakpoint command. You can also pipe breakpoint objects to Remove-PSBreakpoint.

-Id <Int32[]>

  • This value is required
  • Default value is None
  • Accepts pipeline input ByPropertyName

Specifies breakpoint IDs for which this cmdlet deletes breakpoints.

-Confirm [<SwitchParameter>]

  • Default value is false

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.

-WhatIf [<SwitchParameter>]

  • Default value is false

Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs

System.Management.Automation.Breakpoint

You can pipe breakpoint objects to Remove-PSBreakpoint.

Outputs

None

The cmdlet does not generate any output.

Examples
  1. Remove all breakpoints:
    PS C:> Get-PSBreakpoint | Remove-PSBreakpoint
    

    This command deletes all of the breakpoints in the current console.

  2. Remove a specified breakpoint:
    PS C:> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
    PS C:> $B | Remove-PSBreakpoint
    

    This command deletes a breakpoint.

    The first command uses the Set-PSBreakpoint cmdlet to create a breakpoint on the Name variable in the Sample.ps1 script. Then, it saves the breakpoint object in the $B variable.

    The second command uses the Remove-PSBreakpoint cmdlet to delete the new breakpoint. It uses a pipeline operator (|) to send the breakpoint object in the $B variable to the Remove-PSBreakpoint cmdlet.

    As a result of this command, if you run the script, it runs to completion without stopping. Also, the Get-PSBreakpoint cmdlet does not return this breakpoint.

  3. Remove a breakpoint by ID:
    PS C:> Remove-PSBreakpoint -Id 2
    

    This command deletes the breakpoint with breakpoint ID 2.

  4. Use a function to remove all breakpoints:
    PS C:> function del-psb { get-psbreakpoint | remove-psbreakpoint }
    
       This simple function deletes all of the breakpoints in the current console. It uses the Get-PSBreakpoint cmdlet to 
       get the breakpoints. Then, it uses a pipeline operator (|) to send the breakpoints to the Remove-PSBreakpoint 
       cmdlet, which deletes them.
       As a result, you can type del-psb instead of the longer command.
       To save the function, add it to your Windows PowerShell profile.
Related Links

Disable-PSBreakpoint
Enable-PSBreakpoint
Get-PSBreakpoint
Get-PSCallStack
Set-PSBreakpoint