Compartir a través de


Disable-PSBreakpoint

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

Sintaxis

Breakpoint (valor predeterminado)

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

Id

Disable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Disable-PSBreakpoint deshabilita los puntos de interrupción, lo que garantiza que no se alcanzan cuando se ejecuta el script. Puede usarlo para deshabilitar todos los puntos de interrupción o puede especificar puntos de interrupción mediante el envío de objetos de punto de interrupción o identificadores de punto de interrupción.

Técnicamente, este cmdlet cambia el valor de la propiedad Enabled de un objeto de punto de interrupción a False. Para volver a habilitar un punto de interrupción, use el cmdlet Enable-PSBreakpoint. Los puntos de interrupción se habilitan de forma predeterminada al crearlos mediante el cmdlet Set-PSBreakpoint.

Un punto de interrupción es un punto de un script donde la ejecución se detiene temporalmente para poder examinar las instrucciones del script. Disable-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: Establecer un punto de interrupción y deshabilitarlo

Estos comandos deshabilitan un punto de interrupción recién creado.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

El cmdlet Set-PSBreakpoint crea un punto de interrupción en la variable $Name en el script de Sample.ps1 y guarda el objeto de punto de interrupción en la variable $B. El cmdlet Disable-PSBreakpoint deshabilita el nuevo punto de interrupción. Usa un operador de canalización (|) para enviar el objeto de punto de interrupción en $B al cmdlet Disable-PSBreakpoint.

Como resultado de este comando, el valor de la propiedad Enabled del objeto de punto de interrupción de $B es False.

Ejemplo 2: Deshabilitar un punto de interrupción

Este comando deshabilita el punto de interrupción con el identificador de punto de interrupción 0.

Disable-PSBreakpoint -Id 0

Ejemplo 3: Crear un punto de interrupción deshabilitado

Este comando crea un nuevo punto de interrupción que está deshabilitado hasta habilitarlo.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Usa el cmdlet Disable-PSBreakpoint para deshabilitar el punto de interrupción. El valor del parámetro punto de interrupción 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 objetos como sus valores pueden aceptar una variable que contenga 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 usar como valor del parámetro punto de interrupción.

Ejemplo 4: Deshabilitar todos los puntos de interrupción de la consola actual

Este comando deshabilita todos los puntos de interrupción de la consola actual.

`Get-PSBreakpoint` | Disable-PSBreakpoint

Parámetros

-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 obtenga objetos de punto de interrupción, como un comando Get-PSBreakpoint. También puede canalizar objetos de punto de interrupción al cmdlet Disable-PSBreakpoint.

Propiedades de parámetro

Tipo:

Breakpoint[]

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

Conjuntos de parámetros

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

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

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

Deshabilita los puntos de interrupción con los identificadores de punto de interrupción especificados. Escriba los identificadores o una variable que contenga los identificadores. No se pueden canalizar los identificadores a Disable-PSBreakpoint.

Propiedades de parámetro

Tipo:

Int32[]

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

Conjuntos de parámetros

Id
Posición:0
Obligatorio: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 los puntos de interrupción habilitados. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades de parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio: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 para Disable-PSBreakpoint.

Salidas

None or System.Management.Automation.Breakpoint

Cuando se usa el parámetro PassThru , Disable-PSBreakpoint devuelve un objeto que representa el punto de interrupción deshabilitado. De lo contrario, este cmdlet no genera ninguna salida.