Disabilita i punti di interruzione nella console corrente.
Sintassi
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Disable-PSBreakpoint consente di disabilitare i punti di interruzione, il che ne garantisce l'esclusione durante l'esecuzione dello script. È possibile utilizzarlo per disabilitare tutti i punti di interruzione o specificare i punti di interruzione inviando oggetti o ID punto di interruzione.
Tecnicamente, questo cmdlet consente di impostare su False il valore della proprietà Enabled di un oggetto punto di interruzione. Per abilitare nuovamente un punto di interruzione, utilizzare il cmdlet Enable-PSBreakpoint. I punti di interruzione vengono abilitati per impostazione predefinita quando vengono creati tramite il cmdlet Set-PSBreakpoint.
Un punto di interruzione è un punto di uno script in cui l'esecuzione viene interrotta temporaneamente per consentire l'analisi delle istruzioni nello script. Disable-PSBreakpoint è uno dei diversi cmdlet progettato 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 disabilitare. 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 al cmdlet Disable-PSBreakpoint.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-Id <Int32[]>
Disabilita i punti di interruzione con gli ID punto di interruzione specificati. Immettere gli ID o una variabile che li contenga. Non è possibile reindirizzare gli ID a Disable-PSBreakpoint.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-PassThru
Restituisce un oggetto che rappresenta i punti di interruzione abilitati. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
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 Disable-PSBreakpoint. |
|
Output |
Nessuno o System.Management.Automation.Breakpoint Quando si utilizza il parametro PassThru, Disable-PSBreakpoint restituisce un oggetto che rappresenta il punto di interruzione disabilitato. Negli altri casi, il cmdlet non genera alcun output. |
Esempio 1
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name C:\PS> $b | disable-psbreakpoint Descrizione ----------- Con questi comandi viene disabilitato un punto di interruzione appena creato. 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. Viene utilizzato un operatore pipeline (|) per inviare l'oggetto punto di interruzione in $b al cmdlet Disable-PSBreakpoint. Come conseguenza del comando, il valore della proprietà Enabled dell'oggetto punto di interruzione in $b sarà False.
Esempio 2
C:\PS>disable-psbreakpoint -id 0 Descrizione ----------- Con questo comando viene disabilitato il punto di interruzione il cui ID è 0.
Esempio 3
C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) C:\PS> $b Descrizione ----------- Con questo comando viene creato un nuovo punto di interruzione disabilitato fino all'abilitazione. Viene utilizzato il cmdlet Disable-PSBreakpoint per disabilitare il punto di interruzione. Il valore del parametro Breakpoint è un comando Set-PSBreakpoint che imposta un nuovo punto di interruzione, genera un oggetto punto di interruzione e salva l'oggetto nella variabile $b. I parametri dei cmdlet che accettano gli oggetti come valori possono accettare una variabile che contiene l'oggetto o un comando che ottiene o genera l'oggetto. In questo caso, poiché Set-PSBreakpoint genera un oggetto punto di interruzione, può essere utilizzato come valore del parametro Breakpoint. Con il secondo comando l'oggetto punto di interruzione viene visualizzato nel valore della variabile $b.
Esempio 4
C:\PS>get-psbreakpoint | disable-psbreakpoint Descrizione ----------- Con questo comando vengono disabilitati tutti i punti di interruzione nella console corrente. È possibile abbreviare questo comando in: "gbp | dbp".
Vedere anche