Disable-PSBreakpoint
Deshabilita los puntos de interrupción en la consola actual.
Sintaxis
Breakpoint (valor predeterminado)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-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
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 de parámetro
| Tipo: | |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Breakpoint
| Posición: | 0 |
| Obligatorio: | 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 de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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 de parámetro
| Tipo: | Int32[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Id
| Posición: | 0 |
| Obligatorio: | 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 de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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 para Disable-PSBreakpoint.
Salidas
None or System.Management.Automation.Breakpoint
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.