Condividi tramite

Enable-PSBreakpoint

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Abilita i punti di interruzione nella console corrente.

Sintassi

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

Descrizione

Il Enable-PSBreakpoint cmdlet abilita nuovamente i punti di interruzione disabilitati. È possibile usarlo per abilitare tutti i punti di interruzione o punti di interruzione specifici fornendo oggetti o ID punto di interruzione.

Un punto di interruzione è un punto in uno script in cui l'esecuzione si arresta temporaneamente in modo che sia possibile esaminare lo stato dello script. I punti di interruzione appena creati sono abilitati automaticamente, ma possono essere disabilitati usando Disable-PSBreakpoint.

Tecnicamente, questo cmdlet modifica il valore della proprietà Enabled di un oggetto punto di interruzione su True.

Enable-PSBreakpoint è uno dei diversi cmdlet progettati per il debug degli script di PowerShell. Per altre informazioni sul debugger di PowerShell, vedere about_Debuggers.

Esempio

Esempio 1: Abilitare tutti i punti di interruzione

In questo esempio vengono attivati tutti i punti di interruzione nella sessione corrente.

Get-PSBreakpoint | Enable-PSBreakpoint

Usando gli alias, questo esempio può essere abbreviato come gbp | ebp.

Esempio 2: Abilitare i punti di interruzione in base all'ID

Questo esempio abilita più punti di interruzione usando gli ID punto di interruzione.

Enable-PSBreakpoint -Id 0, 1, 5

Esempio 3: Abilitare un punto di interruzione disabilitato

In questo esempio viene riattivato un punto di interruzione disabilitato.

$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 di interruzione nella variabile Name nello Sample.ps1 script che salva l'oggetto punto di interruzione nella $B variabile. Il parametro PassThru visualizza il valore della proprietà Enabled del punto di interruzione è False.

Enable-PSBreakpoint riabilita il punto di interruzione. Anche in questo caso, usando il parametro PassThru si noterà che il valore della proprietà Enabled è True.

Esempio 4: Abilitare i punti di interruzione usando una variabile

In questo esempio viene abilitato un set di punti di interruzione usando gli oggetti punto di interruzione.

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

Get-PSBreakpoint ottiene i punti di interruzione e li salva nella $B variabile. Usando il parametro Punto di interruzione, Enable-PSBreakpoint abilita i punti di interruzione.

Questo esempio equivale all'esecuzione Enable-PSBreakpoint -Id 3, 5di .

Parametri

-Breakpoint

Specifica i punti di interruzione da abilitare. Specificare una variabile contenente punti di interruzione o un comando che ottiene oggetti punto di interruzione, ad esempio Get-PSBreakpoint. È anche possibile inviare oggetti di punto di interruzione pipe a Enable-PSBreakpoint.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Id

Specifica i numeri ID dei punti di interruzione da abilitare. Il valore predefinito è tutti i punti di interruzione. Specificare l'ID per numero o in una variabile. Non è possibile inviare numeri id pipe a Enable-PSBreakpoint. Per trovare l'ID di un punto di interruzione, usare il Get-PSBreakpoint cmdlet.

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

-PassThru

Restituisce un oggetto che rappresenta il punto di interruzione abilitato. Per impostazione predefinita, questo cmdlet non genera alcun output.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

Breakpoint

È possibile eseguire la pipe di un oggetto punto di interruzione in Enable-PSBreakpoint.

Output

None or System.Management.Automation.Breakpoint

Quando si usa il parametro PassThru , Enable-PSBreakpoint restituisce un oggetto punto di interruzione che rappresenta il punto di interruzione abilitato. In caso contrario, questo cmdlet non genera alcun output.

Note

  • Il Enable-PSBreakpoint cmdlet non genera un errore se si tenta di abilitare un punto di interruzione già abilitato. Di conseguenza, è possibile abilitare tutti i punti di interruzione senza errori, anche se solo alcuni sono disabilitati.

  • I punti di interruzione vengono abilitati quando vengono creati usando il Set-PSBreakpoint cmdlet. Non è necessario abilitare i punti di interruzione appena creati.