Búsqueda de sitios web

Habilitar-PSBreakpoint (Microsoft.PowerShell.Utility)

Habilitar-PSBreakpoint

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

Descripción

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 ID de puntos de interrupción.

Un punto de interrupción es un punto en 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 usando 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 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

Este ejemplo habilita todos los puntos de interrupción en la sesión actual.

Get-PSBreakpoint | Enable-PSBreakpoint

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

Ejemplo 2: habilitar puntos de interrupción por ID

Este ejemplo habilita varios puntos de interrupción utilizando sus ID de punto de interrupción.

Enable-PSBreakpoint -Id 0, 1, 5

Ejemplo 3: habilitar un punto de interrupción deshabilitado

Este ejemplo 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 y guarda el objeto de punto de interrupción en $Bvariable. El parámetro PassThru muestra que el valor de la propiedad Enabled del punto de interrupción es False.

Enable-PSBreakpoint vuelve a habilitar el punto de interrupción. Nuevamente, usando el parámetro PassThru vemos que el valor de la propiedad Enabled es True.

Ejemplo 4: habilitar puntos de interrupción usando una variable

Este ejemplo habilita un conjunto de puntos de interrupción utilizando 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. Usando el parámetro Punto de interrupción, Enable-PSBreakpoint habilita los puntos de interrupción.

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

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

En este ejemplo, un trabajo se inicia con un punto de interrupción configurado para interrumpirse y luego deshabilitado. 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 habilitarán. 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 a Enable-PSBreakpoint.

Tipo :

Punto de interrupción[]

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Id

Especifica los números Id de los puntos de interrupción que se habilitarán. El valor predeterminado son todos los puntos de interrupción. Proporcione el Id por número o en una variable. No puede canalizar números Id a Enable-PSBreakpoint. Para encontrar el Id de un punto de interrupción, utilice 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 habilita. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Runspace

Especifica el ID 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 :

Espacio de ejecución

Alias:

RunspaceId

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-WhatIf

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

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Punto de interrupción

Puede canalizar un objeto de punto de interrupción a este cmdlet.

Salidas

Ninguno

De forma predeterminada, este cmdlet no devuelve ningún resultado.

Punto de interrupción

Cuando se utiliza 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. Como tal, puede habilitar todos los puntos de interrupción sin errores, incluso cuando solo unos pocos estén deshabilitados.

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

Artículos relacionados