Remove-PSBreakpoint

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Elimina los puntos de interrupción de la consola actual.

Syntax

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

Description

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

Cuando se quita un punto de interrupción, el objeto de punto de interrupción deja de estar disponible o funcional. Si se guardó un objeto de punto de interrupción en una variable, la referencia todavía existe, 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 en 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 Set-PSBreakpoint cmdlet crea un punto de interrupción en la $Name variable del Sample.ps1 script y guarda el objeto de punto de interrupción en la $B variable. El Remove-PSBreakpoint cmdlet elimina el nuevo punto de interrupción. Usa un operador de canalización (|) para enviar el objeto de punto de interrupción en la $B variable al Remove-PSBreakpoint cmdlet .

Como resultado de este comando, si se ejecuta el script, este se ejecuta sin detenerse hasta completarse. Además, el Get-PSBreakpoint cmdlet 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 Get-PSBreakpoint cmdlet para obtener los puntos de interrupción. A continuación, usa un operador de canalización (|) para enviar los puntos de interrupción al Remove-PSBreakpoint cmdlet , 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 que se interrumpa cuando se ejecute 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 se canaliza para Remove-PSBreakpoint quitar el punto de Get-PSBreakPoint 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 Get-PSBreakpoint comando. También puede canalizar objetos de punto de interrupción a Remove-PSBreakpoint.

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Breakpoint[]

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

Int32[]

Runspace

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-PSBreakpoint:

  • Todas las plataformas:
    • rbp