Compartir a través de

Disable-PSBreakpoint

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Syntax

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-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. Se puede usar para deshabilitar todos los puntos de interrupción, o bien se pueden especificar puntos de interrupción concretos enviando los objetos de punto de interrupción o identificadores de punto de interrupción correspondientes.

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

Un punto de interrupción es un punto en un script en el que la ejecución se detiene temporalmente para que se puedan examinar las instrucciones. Disable-PSBreakpoint es uno de los varios cmdlets diseñados para depurar scripts Windows PowerShell. Para obtener más información acerca del depurador de Windows PowerShell, consulte about_Debuggers.

Ejemplos

Ejemplo 1: Establecer un punto de interrupción y deshabilitarlo

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Estos comandos deshabilitan un punto de interrupción creado recientemente.

El primer comando usa 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. 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 en $B es False.

Ejemplo 2: Deshabilitar un punto de interrupción

PS C:\> Disable-PSBreakpoint -Id 0

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

Ejemplo 3: Create un punto de interrupción deshabilitado

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Este comando crea un punto de interrupción que está deshabilitado hasta que el usuario lo habilite.

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 obtenga o genere 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 .

El segundo comando muestra el objeto de punto de interrupción en el valor de la variable $B.

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

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Este comando deshabilita todos los puntos de interrupción en la consola actual. Puede abreviar este comando como: "gbp | dbp".

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 .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica una matriz de identificadores o variables que contiene los identificadores de punto de interrupción. No se pueden canalizar los identificadores a Disable-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Breakpoint

Puede canalizar un objeto de punto de interrupción a 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 resultados.