Habilita los puntos de interrupción en la consola actual.
Sintaxis
Enable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Enable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Enable-PSBreakpoint vuelve a habilitar los puntos de interrupción deshabilitados. Puede utilizarlo para habilitar todos los puntos de interrupción o puede especificar los puntos de interrupción enviando objetos o identificadores de punto de interrupción.
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. Los nuevos puntos de interrupción se habilitan automáticamente, pero es posible deshabilitarlos mediante el cmdlet Disable-PSBreakpoint.
Técnicamente, este cmdlet cambia a True el valor de la propiedad Enabled de un objeto de punto de interrupción.
Enable-PSBreakpoint es uno de los diversos cmdlets diseñados para depurar 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 habilitar. 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 a Enable-PSBreakpoint.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
None. |
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Id <Int32[]>
Habilita los puntos de interrupción con los identificadores especificados. El valor predeterminado es todos los puntos de interrupción. Escriba los identificadores o una variable que los contenga. (No puede canalizar los identificadores a Enable-PSBreakpoint.) Para obtener el identificador de un punto de interrupción, utilice el cmdlet Get-PSBreakpoint.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve un objeto que representa el punto de interrupción habilitado. De forma predeterminada, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
No output |
|
¿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 Enable-PSBreakpoint. |
|
Salidas |
Ninguno o System.Management.Automation.Breakpoint Cuando se usa el parámetro PassThru, Enable-PSBreakpoint devuelve un objeto de punto de interrupción que representa el punto de interrupción habilitado. En caso contrario, este cmdlet no genera resultados. |
Notas
El cmdlet Enable-PSBreakpoint no genera un error si se intenta habilitar un punto de interrupción ya habilitado. Como tal, se pueden habilitar todos los puntos de interrupción sin que se genere ningún error, incluso si solo hay algunos que están deshabilitados.
Los puntos de interrupción están habilitados si se crean mediante el cmdlet Set-PSBreakpoint. No es preciso habilitar los puntos de interrupción que se acaban de crear.
Ejemplo 1
C:\PS>get-psbreakpoint | enable-psbreakpoint Descripción ----------- Este comando habilita todos los puntos de interrupción en la consola actual. Este comando puede abreviarse como: "gbp | ebp".
Ejemplo 2
C:\PS>enable-psbreakpoint -id 0, 1, 5 Descripción ----------- Este comando habilita los puntos de interrupción con los identificadores 0, 1 y 5.
Ejemplo 3
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name C:\PS> $b | disable-psbreakpoint -passthru AccessMode : Write Variable : Name Action : Enabled : False HitCount : 0 Id : 0 Script : C:\ps-test\sample.ps1 ScriptName : C:\ps-test\sample.ps1 C:\PS> $b | enable-psbreakpoint -passthru AccessMode : Write Variable : Name Action : Enabled : True HitCount : 0 Id : 0 Script : C:\ps-test\sample.ps1 ScriptName : C:\ps-test\sample.ps1 Descripción ----------- Estos comandos vuelven a habilitar un punto de interrupción que se ha deshabilitado. 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 almacenado en $b al cmdlet Disable-PSBreakpoint y utiliza el parámetro PassThru de Disable-PSBreakpoint para mostrar el objeto de punto de interrupción deshabilitado. De este modo, se puede comprobar que el valor de la propiedad Enabled del objeto de punto de interrupción es False. El tercer comando usa el cmdlet Enable-PSBreakpoint para volver a habilitar el punto de interrupción. Utiliza un operador de canalización (|) para enviar el objeto de punto de interrupción almacenado en $b al cmdlet Enable-PSBreakpoint y utiliza el parámetro PassThru de Enable-PSBreakpoint para mostrar el objeto de punto de interrupción. De este modo, se puede comprobar que el valor de la propiedad Enabled del objeto de punto de interrupción es True. Los resultados se muestran en el siguiente ejemplo.
Ejemplo 4
C:\PS>$b = get-psbreakpoint -id 3, 5 C:\PS> enable-psbreakpoint -breakpoint $b Descripción ----------- Estos comandos habilitan un conjunto de puntos de interrupción especificando sus objetos de punto de interrupción. El primer comando utiliza el cmdlet Get-PSBreakpoint para obtener los puntos de interrupción y los guarda en la variable $b. El segundo comando usa el cmdlet Enable-PSBreakpoint y su parámetro Breakpoint para habilitar los puntos de interrupción. Este comando equivale a "enable-psbreakpoint -id 3, 5".
Vea también