Compartir vía

Disable-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

Breakpoint (Es el valor predeterminado). 

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

Id 

Disable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-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.

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

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.

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

-PassThru

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

Propiedades del parámetro

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

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

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