Eliminar-PSBreakpoint (Microsoft.PowerShell.Utility)

Eliminar-PSBreakpoint

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>]

Descripción

El cmdlet Remove-PSBreakpoint elimina un punto de interrupción. Introduzca un objeto de punto de interrupción o un ID de punto de interrupción.

Cuando elimina un punto de interrupción, el objeto del punto de interrupción ya no está disponible ni es funcional. Si ha guardado un objeto de punto de interrupción en una variable, la referencia aún existe, pero el punto de interrupción no funciona.

Remove-PSBreakpoint es uno de 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: eliminar 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: eliminar 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 Sample.ps1 y guarda el objeto de punto de interrupción en el archivo . $B variable. El cmdlet Remove-PSBreakpoint elimina el nuevo punto de interrupción. Utiliza 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 ejecutará hasta su finalización sin detenerse. Además, el cmdlet Get-PSBreakpoint no devuelve este punto de interrupción.

Ejemplo 3: eliminar un punto de interrupción por ID

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

Remove-PSBreakpoint -Id 2

Ejemplo 4: utilizar una función para eliminar todos los puntos de interrupción

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

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

Utiliza el cmdlet Get-PSBreakpoint para obtener los puntos de interrupción. Luego, utiliza un operador de canalización (|) para enviar los puntos de interrupción al cmdlet Remove-PSBreakpoint, que los elimina.

Ejemplo 5: eliminar 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 cuando se ejecuta 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 eliminar 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 eliminarán. Introduzca 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 a Remove-PSBreakpoint.

Tipo :

Punto de interrupción[]

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Id

Especifica los identificadores de puntos de interrupción para los cuales este cmdlet elimina 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 ID 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 :

Espacio de ejecución

Alias:

RunspaceId

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-WhatIf

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

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Punto de interrupción[]

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

Int32[]

Espacio de ejecución

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-PSBreakpoint:

• Todas las plataformas:

  rbp