Disable-PSBreakpoint

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

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

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 Windows PowerShell. Para obtener más información sobre el depurador de Windows PowerShell, consulte about_Debuggers.

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Estos comandos deshabilitan un punto de interrupción recién creado.

El primer comando usa el cmdlet Set-PSBreakpoint para crear un punto de interrupción en la variable name de en el script de Sample.ps1. A continuación, guarda el objeto de punto de interrupción en la variable $B.

El segundo comando usa el cmdlet disable-PSBreakpoint para deshabilitar 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 en $B es False.

PS C:\> Disable-PSBreakpoint -Id 0

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

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Este comando crea un nuevo punto de interrupción que está deshabilitado hasta habilitarlo.

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 el valor del parámetro Punto de interrupción.

El segundo comando muestra el objeto de punto de interrupción en el valor de la variable $B.

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Este comando deshabilita todos los puntos de interrupción de la consola actual. Puede abreviar este comando como: "gbp | dbp".

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.

Puede canalizar un objeto de punto de interrupción para Disable-PSBreakpoint.

Cuando se usa el parámetro PassThru, Disable-PSBreakpoint devuelve un objeto que representa el punto de interrupción deshabilitado. De lo contrario, este cmdlet no genera ninguna salida.