Compartir a través de

Remove-PSBreakpoint

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Elimina puntos de interrupción de la consola actual.

Sintaxis

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

Description

El cmdlet Remove-PSBreakpoint elimina un punto de interrupción. Escriba un objeto de punto de interrupción o un identificador de punto de interrupción.

Al quitar un punto de interrupción, el objeto de punto de interrupción ya no está disponible ni funcional. Si ha guardado un objeto de punto de interrupción en una variable, la referencia sigue existiendo, pero el punto de interrupción no funciona.

Remove-PSBreakpoint es uno de los varios cmdlets diseñados para depurar scripts de PowerShell. Para obtener más información sobre el depurador de PowerShell, consulte about_Debuggers.

Ejemplos

Ejemplo 1: Quitar todos los puntos de interrupción

Este comando elimina todos los puntos de interrupción de la consola actual.

Get-PSBreakpoint | Remove-PSBreakpoint

Ejemplo 2: Quitar un punto de interrupción especificado

Este comando elimina un punto de interrupción.

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

El cmdlet Set-PSBreakpoint crea un punto de interrupción en la variable $Name en el script de Sample.ps1 y guarda el objeto de punto de interrupción en la variable $B. El cmdlet Remove-PSBreakpoint elimina el nuevo punto de interrupción. Usa un operador de canalización (|) para enviar el objeto de punto de interrupción en la variable $B al cmdlet Remove-PSBreakpoint.

Como resultado de este comando, si ejecuta el script, se ejecuta hasta la finalización sin detener. Además, el cmdlet Get-PSBreakpoint no devuelve este punto de interrupción.

Ejemplo 3: Quitar un punto de interrupción por identificador

Este comando elimina el punto de interrupción con el identificador de punto de interrupción 2.

Remove-PSBreakpoint -Id 2

Ejemplo 4: Uso de una función para quitar todos los puntos de interrupción

Esta función simple elimina todos los puntos de interrupción de la sesión actual.

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

Usa el cmdlet Get-PSBreakpoint para obtener los puntos de interrupción. A continuación, usa un operador de canalización (|) para enviar los puntos de interrupción al cmdlet Remove-PSBreakpoint, que los elimina.

Ejemplo 5: Quitar un punto de interrupción en un espacio de ejecución

En este ejemplo, se inicia un trabajo y se establece un punto de interrupción para interrumpir cuando se ejecuta el Set-PSBreakPoint. El espacio de ejecución se almacena en una variable y se pasa al comando Get-PSBreakPoint con el parámetro Runspace. La salida de Get-PSBreakPoint se canaliza a Remove-PSBreakpoint para quitar el punto de interrupción en el espacio de ejecución.

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

Parámetros

-Breakpoint

Especifica los puntos de interrupción que se van a eliminar. Escriba una variable que contenga objetos de punto de interrupción o un comando que obtenga objetos de punto de interrupción, como un comando Get-PSBreakpoint. También puede canalizar objetos de punto de interrupción para Remove-PSBreakpoint.

Tipo:Breakpoint[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica los identificadores de punto de interrupción para los que este cmdlet elimina los puntos de interrupción.

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Runspace

Especifica el identificador de un objeto Runspace para que pueda interactuar con puntos de interrupción en el espacio de ejecución especificado.

Este parámetro se agregó en PowerShell 7.2.

Tipo:Runspace
Alias:RunspaceId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Breakpoint[]

Puede canalizar objetos de punto de interrupción a este cmdlet.

Int32[]

Runspace

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

PowerShell incluye los siguientes alias para Remove-PSBreakpoint:

  • Todas las plataformas:
    • rbp