Deshabilita los puntos de interrupción en la consola actual.
Sintaxis
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Disable-PSBreakpoint deshabilita los puntos de interrupción, lo que garantiza que no se alcanzarán cuando se ejecute el script. Puede utilizarlo para deshabilitar todos los puntos de interrupción o puede especificar los puntos de interrupción enviando objetos o identificadores de punto de interrupción.
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, utilice el cmdlet Enable-PSBreakpoint. De forma predeterminada, los puntos de interrupción están habilitados si se crean mediante el cmdlet Set-PSBreakpoint.
Un punto de interrupción es un punto en un script donde la ejecución se detiene temporalmente para que se puedan examinar las instrucciones incluidas en el script. Disable-PSBreakpoint es uno de los diversos cmdlets diseñados para la depuración de los scripts de Windows PowerShell. Para obtener más información acerca del depurador de Windows PowerShell, vea about_Debuggers.
Parámetros
-Breakpoint <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 los obtenga, como un comando Get-PSBreakpoint. También puede canalizar los objetos de punto de interrupción al cmdlet Disable-PSBreakpoint.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Id <Int32[]>
Deshabilita los puntos de interrupción con los identificadores especificados. Escriba los identificadores o una variable que los contenga. No puede canalizar los identificadores a Disable-PSBreakpoint.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve un objeto que representa los puntos de interrupción habilitados. De forma predeterminada, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.Management.Automation.Breakpoint Puede canalizar un objeto de punto de interrupción a Disable-PSBreakpoint. |
|
Salidas |
Ninguno o System.Management.Automation.Breakpoint Cuando se usa el parámetro PassThru, Disable-PSBreakpoint devuelve un objeto que representa el punto de interrupción deshabilitado. En caso contrario, este cmdlet no genera resultados. |
Ejemplo 1
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name C:\PS> $b | disable-psbreakpoint Descripción ----------- Estos comandos deshabilitan un punto de interrupción que se acaba de crear. El primer comando utiliza el cmdlet Set-PSBreakpoint para crear un punto de interrupción en la variable Name del script 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. Utiliza un operador de canalización (|) para enviar el objeto de punto de interrupción guardado en la variable $b al cmdlet Disable-PSBreakpoint. Como resultado de este comando, el valor de la propiedad Enabled del objeto de punto de interrupción almacenado en $b es False.
Ejemplo 2
C:\PS>disable-psbreakpoint -id 0 Descripción ----------- Este comando deshabilita el punto de interrupción con el identificador 0.
Ejemplo 3
C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) C:\PS> $b Descripción ----------- Este comando crea un nuevo punto de interrupción que estará deshabilitado hasta que se habilite. Utiliza el cmdlet Disable-PSBreakpoint para deshabilitar el punto de interrupción. El valor del parámetro Breakpoint 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 un objeto como valor pueden aceptar una variable que contiene 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 utilizarlo como valor del parámetro Breakpoint. El segundo comando muestra el objeto de punto de interrupción en el valor de la variable $b.
Ejemplo 4
C:\PS>get-psbreakpoint | disable-psbreakpoint Descripción ----------- Este comando deshabilita todos los puntos de interrupción en la consola actual. Este comando puede abreviarse como: "gbp | dbp".
Vea también