Compartir vía

Remove-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

Elimina puntos de interrupción de la consola actual.

Sintaxis

Breakpoint (Es el valor predeterminado). 

Remove-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id 

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.

Propiedades del parámetro

Tipo:

Breakpoint[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Breakpoint
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

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

Propiedades del parámetro

Tipo:

Int32[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Id
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Runspace
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:RunspaceId

Conjuntos de parámetros

Id
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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