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.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
None. |
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-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.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-PassThru
Restituisce un oggetto che rappresenta il punto di interruzione abilitato. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
No output |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<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.
|
Input |
System.Management.Automation.Breakpoint È possibile reindirizzare un oggetto punto di interruzione a Enable-PSBreakpoint. |
|
Output |
Nessuno o System.Management.Automation.Breakpoint Quando si utilizza il parametro PassThru, Enable-PSBreakpoint restituisce un oggetto punto di interruzione che rappresenta il punto di interruzione abilitato. Negli altri casi, il cmdlet non genera alcun output. |
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