Compartir a través de

Enable-PSBreakpoint

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Sintaxis

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Enable-PSBreakpoint vuelve a habilitar los puntos de interrupción deshabilitados. Puede usarlo para habilitar todos los puntos de interrupción o puntos de interrupción específicos proporcionando objetos o identificadores de punto de interrupción.

Un punto de interrupción es un punto de un script donde la ejecución se detiene temporalmente para que pueda examinar el estado del script. Los puntos de interrupción recién creados se habilitan automáticamente, pero se pueden deshabilitar mediante Disable-PSBreakpoint.

Técnicamente, este cmdlet cambia el valor de la propiedad Enabled de un objeto de punto de interrupción a True.

Enable-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: Habilitar todos los puntos de interrupción

En este ejemplo se habilitan todos los puntos de interrupción de la sesión actual.

Get-PSBreakpoint | Enable-PSBreakpoint

Con alias, este ejemplo se puede abreviar como gbp | ebp.

Ejemplo 2: Habilitar puntos de interrupción por identificador

En este ejemplo se habilitan varios puntos de interrupción mediante sus identificadores de punto de interrupción.

Enable-PSBreakpoint -Id 0, 1, 5

Ejemplo 3: Habilitar un punto de interrupción deshabilitado

En este ejemplo se vuelve a habilitar un punto de interrupción que se ha deshabilitado.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-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

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint crea un punto de interrupción en la variable Name en el script Sample.ps1 guardando el objeto de punto de interrupción en la variable $B. El parámetro PassThru muestra el valor de la propiedad Enabled del punto de interrupción es False.

Enable-PSBreakpoint volver a habilitar el punto de interrupción. De nuevo, con el parámetro passThru de vemos que el valor de la propiedad Enabled es True.

Ejemplo 4: Habilitación de puntos de interrupción mediante una variable

En este ejemplo se habilita un conjunto de puntos de interrupción mediante los objetos de punto de interrupción.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint obtiene los puntos de interrupción y los guarda en la variable $B. Con el parámetro punto de interrupción, Enable-PSBreakpoint habilita los puntos de interrupción.

Este ejemplo es equivalente a ejecutar Enable-PSBreakpoint -Id 3, 5.

Ejemplo 5: Habilitar un punto de interrupción en un espacio de ejecución

En este ejemplo, se inicia un trabajo con un punto de interrupción para interrumpir y, a continuación, se deshabilita. 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 Enable-PSBreakpoint para habilitar el punto de interrupción en el espacio de ejecución.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Parámetros

-Breakpoint

Especifica los puntos de interrupción que se van a habilitar. Proporcione una variable que contenga puntos de interrupción o un comando que obtenga objetos de punto de interrupción, como Get-PSBreakpoint. También puede canalizar objetos de punto de interrupción para Enable-PSBreakpoint.

Tipo:Breakpoint[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica el identificador de números de los puntos de interrupción que se van a habilitar. El valor predeterminado es todos los puntos de interrupción. Proporcione el identificador de por número o en una variable. No se pueden canalizar id. números a Enable-PSBreakpoint. Para buscar el identificador de de un punto de interrupción, use el cmdlet Get-PSBreakpoint.

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el punto de interrupción que se está habilitando. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Runspace
Alias:RunspaceId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

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

Notas

PowerShell incluye los siguientes alias para Enable-PSBreakpoint:

  • Todas las plataformas:

    • ebp

  • El cmdlet Enable-PSBreakpoint no genera un error si intenta habilitar un punto de interrupción que ya está habilitado. Por lo tanto, puede habilitar todos los puntos de interrupción sin error, incluso cuando solo se deshabilitan algunos.

  • Los puntos de interrupción se habilitan al crearlos mediante el cmdlet Set-PSBreakpoint. No es necesario habilitar los puntos de interrupción recién creados.