Compartir a través de

Disable-PSBreakpoint

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Sintaxis

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

Description

El cmdlet Disable-PSBreakpoint deshabilita los puntos de interrupción, lo que garantiza que no se alcanzan cuando se ejecuta el script. Puede usarlo para deshabilitar todos los puntos de interrupción o puede especificar puntos de interrupción mediante el envío de objetos de punto de interrupción o identificadores de punto de interrupción.

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

Un punto de interrupción es un punto de un script donde la ejecución se detiene temporalmente para poder examinar las instrucciones del script. 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 recién creado.

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

Como resultado de este comando, el valor de la propiedad Enabled del objeto de punto de interrupción de $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 nuevo punto de interrupción que está deshabilitado hasta habilitarlo.

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

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

Los parámetros de cmdlet que toman objetos como sus valores pueden aceptar una variable que contenga el objeto o un comando que obtiene o genera 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 de 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 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 Disable-PSBreakpoint para deshabilitar 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 | 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 comando Get-PSBreakpoint. También puede canalizar objetos de punto de interrupción al cmdlet Disable-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

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

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

-PassThru

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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 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