Compartir vía

Enable-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

Breakpoint (Es el valor predeterminado). 

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

Id 

Enable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-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

crea un punto de interrupción en la variable Name en el script guardando el objeto de punto de interrupción en la variable . 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, 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.

Propiedades del parámetro

Tipo:

Breakpoint[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Breakpoint
Posición:0
Mandatory: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 del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

Int32[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Id
Posición:0
Mandatory: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 el punto de interrupción que se está habilitando. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Runspace
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:RunspaceId

Conjuntos de parámetros

Id
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 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.