Disable-PSBreakpoint

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Deshabilita los puntos de interrupción en la consola actual.

Syntax

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

Description

El Disable-PSBreakpoint cmdlet deshabilita los puntos de interrupción, lo que garantiza que no se alcanzan cuando se ejecuta el script. Se puede usar para deshabilitar todos los puntos de interrupción, o bien se pueden especificar puntos de interrupción concretos enviando los objetos de punto de interrupción o identificadores de punto de interrupción correspondientes.

Técnicamente, este cmdlet cambia a False el valor de la propiedad Enabled de un objeto de punto de interrupción. Para volver a habilitar un punto de interrupción, use el Enable-PSBreakpoint cmdlet . Los puntos de interrupción se habilitan de forma predeterminada al crearlos mediante el Set-PSBreakpoint cmdlet .

Un punto de interrupción es un punto en un script en el que la ejecución se detiene temporalmente para que se puedan examinar las instrucciones. Disable-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: Establecer un punto de interrupción y deshabilitarlo

Estos comandos deshabilitan un punto de interrupción creado recientemente.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-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 Disable-PSBreakpoint cmdlet deshabilita el nuevo punto de interrupción. Usa un operador de canalización (|) para enviar el objeto de punto de interrupción al $BDisable-PSBreakpoint cmdlet .

Como resultado de este comando, el valor de la propiedad Enabled del objeto de punto de interrupción en $B es False.

Ejemplo 2: Deshabilitar un punto de interrupción

Este comando deshabilita el punto de interrupción con el identificador de punto de interrupción 0.

Disable-PSBreakpoint -Id 0

Ejemplo 3: Crear un punto de interrupción deshabilitado

Este comando crea un punto de interrupción que está deshabilitado hasta que el usuario lo habilite.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Usa el Disable-PSBreakpoint cmdlet para deshabilitar el punto de interrupción. El valor del parámetro Breakpoint es un Set-PSBreakpoint comando que establece un nuevo punto de interrupción, genera un objeto de punto de interrupción y guarda el objeto en la $B variable .

Los parámetros de cmdlet que toman objetos como sus valores pueden aceptar una variable que contenga el objeto o un comando que obtenga o genere el objeto. En este caso, dado que Set-PSBreakpoint genera un objeto de punto de interrupción, se puede usar como valor del parámetro Punto de interrupción .

Ejemplo 4: Deshabilitar todos los puntos de interrupción de la consola actual

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

Ejemplo 5: Deshabilitar 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 Disable-PSBreakpoint deshabilitar 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 | Disable-Breakpoint -Runspace $runspace

Parámetros

-Breakpoint

Especifica los puntos de interrupción que se van a deshabilitar. 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 al Disable-PSBreakpoint cmdlet .

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

Deshabilita los puntos de interrupción con los identificadores de punto de interrupción especificados. Escriba los identificadores o una variable que contenga esos identificadores. No se pueden canalizar los identificadores a Disable-PSBreakpoint.

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

-PassThru

Devuelve un objeto que representa los puntos de interrupción habilitados. De forma predeterminada, este cmdlet no genera ningún resultado.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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 un objeto de punto de interrupción a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

Breakpoint

Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto de punto de interrupción que representa el punto de interrupción deshabilitado.

Notas

PowerShell incluye los siguientes alias para Disable-PSBreakpoint:

  • Todas las plataformas:
    • dbp