Enable-PSBreakpoint

Abilita i punti di interruzione nella console corrente.

Sintassi

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

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

Descrizione

Il cmdlet Enable-PSBreakpoint consente di abilitare nuovamente i punti di interruzione disabilitati. È possibile utilizzarlo per abilitare tutti i punti di interruzione o specificare i punti di interruzione inviando oggetti o ID punto di interruzione.

Un punto di interruzione è un punto di uno script in cui viene interrotta temporaneamente l'esecuzione per consentire l'analisi delle istruzioni nello script. I punti di interruzione appena creati vengono automaticamente abilitati, ma è possibile disabilitarli tramite il cmdlet Disable-PSBreakpoint.

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

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

Parametri

-Breakpoint <Breakpoint[]>

Specifica i punti di interruzione da abilitare. Immettere una variabile che contiene oggetti punto di interruzione o un comando che consente di ottenere oggetti punto di interruzione, ad esempio Get-PSBreakpoint. È inoltre possibile reindirizzare gli oggetti punto di interruzione a Enable-PSBreakpoint.

-Id <Int32[]>

Abilita i punti di interruzione con gli ID specificati. Il valore predefinito è tutti i punti di interruzione. Immettere gli ID o una variabile che li contenga. Non è possibile reindirizzare gli ID a Enable-PSBreakpoint. Per trovare l'ID di un punto di interruzione, utilizzare il cmdlet Get-PSBreakpoint.

-PassThru

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

-Confirm

Chiede una conferma prima di eseguire il comando.

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Note

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

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

Esempio 1

C:\PS>get-psbreakpoint | enable-psbreakpoint

Descrizione
-----------
Con questo comando vengono abilitati tutti i punti di interruzione nella console corrente. È possibile abbreviare il comando in "gbp | ebp".

Esempio 2

C:\PS>enable-psbreakpoint -id 0, 1, 5

Descrizione
-----------
Con questo comando vengono abilitati i punti di interruzione con ID 0, 1 e 5.

Esempio 3

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | disable-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

C:\PS> $b | enable-psbreakpoint -passthru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Descrizione
-----------
Con questi comandi viene abilitato nuovamente un punto di interruzione disabilitato.

Nel primo comando viene utilizzato il cmdlet Set-PSBreakpoint per creare un punto di interruzione nella variabile "Name" dello script Sample.ps1. L'oggetto punto di interruzione viene quindi salvato nella variabile $b.

Nel secondo comando viene utilizzato il cmdlet Disable-PSBreakpoint per disabilitare il nuovo punto di interruzione. Vengono utilizzati un operatore pipeline (|) per inviare l'oggetto punto di interruzione in $b al cmdlet Disable-PSBreakpoint e il parametro PassThru di Disable-PSBreakpoint per visualizzare l'oggetto punto di interruzione disabilitato. In questo modo è possibile verificare che il valore della proprietà Enabled dell'oggetto punto di interruzione sia False.

Nel terzo comando viene utilizzato il cmdlet Enable-PSBreakpoint per abilitare nuovamente il punto di interruzione. Vengono utilizzati un operatore pipeline (|) per inviare l'oggetto punto di interruzione in $b al cmdlet Enable-PSBreakpoint e il parametro PassThru di Enable-PSBreakpoint per visualizzare l'oggetto punto di interruzione. In questo modo è possibile verificare che il valore della proprietà Enabled dell'oggetto punto di interruzione sia True.

I risultati vengono illustrati nell'esempio di output seguente.

Esempio 4

C:\PS>$b = get-psbreakpoint -id 3, 5

C:\PS> enable-psbreakpoint -breakpoint $b

Descrizione
-----------
Con questi comandi viene abilitato un set di punti di interruzione specificando gli oggetti punto di interruzione. 

Nel primo comando viene utilizzato il cmdlet Get-PSBreakpoint per ottenere i punti di interruzione, i quali vengono salvati nella variabile $b. 

Nel secondo comando viene utilizzato il cmdlet Enable-PSBreakpoint con il parametro Breakpoint per abilitare i punti di interruzione.
Questo comando equivale a "enable-psbreakpoint - id 3, 5".

Vedere anche

Concetti

about_Debuggers
Set-PSBreakpoint
Disable-PSBreakpoint
Get-PSBreakpoint
Remove-PSBreakpoint
Get-PSCallStack