Disable-PSBreakpoint
Disabilita i punti di interruzione nella console corrente.
Sintassi
Breakpoint (Impostazione predefinita)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Disable-PSBreakpoint disabilita i punti di interruzione, assicurando che non vengano raggiunti quando viene eseguito lo script. È possibile usarlo per disabilitare tutti i punti di interruzione oppure specificare punti di interruzione inviando oggetti punto di interruzione o ID punto di interruzione.
Tecnicamente, questo cmdlet modifica il valore della proprietà Enabled di un oggetto punto di interruzione su False.
Per riabilitare un punto di interruzione, usare il cmdlet Enable-PSBreakpoint. I punti di interruzione vengono abilitati per impostazione predefinita quando vengono creati usando il cmdlet Set-PSBreakpoint.
Un punto di interruzione è un punto in uno script in cui l'esecuzione si arresta temporaneamente in modo da poter esaminare le istruzioni nello script.
Disable-PSBreakpoint è uno dei diversi cmdlet progettati per il debug di script di PowerShell. Per altre informazioni sul debugger di PowerShell, vedere about_Debuggers.
Esempio
Esempio 1: Impostare un punto di interruzione e disabilitarlo
Questi comandi disabilitano un punto di interruzione appena creato.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
Il cmdlet Set-PSBreakpoint crea un punto di interruzione nella variabile $Name nello script Sample.ps1 e salva l'oggetto punto di interruzione nella variabile $B. Il cmdlet Disable-PSBreakpoint disabilita il nuovo punto di interruzione. Usa un operatore pipeline (|) per inviare l'oggetto punto di interruzione in $B al cmdlet Disable-PSBreakpoint.
Di conseguenza di questo comando, il valore della proprietà Enabled dell'oggetto punto di interruzione in $B è False.
Esempio 2: Disabilitare un punto di interruzione
Questo comando disabilita il punto di interruzione con ID punto di interruzione 0.
Disable-PSBreakpoint -Id 0
Esempio 3: Creare un punto di interruzione disabilitato
Questo comando crea un nuovo punto di interruzione disabilitato fino a quando non viene abilitato.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
Usa il cmdlet Disable-PSBreakpoint per disabilitare il punto di interruzione. Il valore del parametro punto di interruzione è 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 del cmdlet che accettano 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 usato come valore del parametro punto di interruzione.
Esempio 4: Disabilitare tutti i punti di interruzione nella console corrente
Questo comando disabilita tutti i punti di interruzione nella console corrente.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Parametri
-Breakpoint
Specifica i punti di interruzione da disabilitare. Immettere una variabile contenente oggetti punto di interruzione o un comando che recupera oggetti punto di interruzione, ad esempio un comando Get-PSBreakpoint. È anche possibile inviare tramite pipe oggetti punto di interruzione al cmdlet Disable-PSBreakpoint.
Proprietà dei parametri
| Tipo: | |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Breakpoint
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Id
Disabilita i punti di interruzione con gli ID punto di interruzione specificati. Immettere gli ID o una variabile che contiene gli ID. Non è possibile inviare tramite pipe GLI ID a Disable-PSBreakpoint.
Proprietà dei parametri
| Tipo: | Int32[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Id
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Restituisce un oggetto che rappresenta i punti di interruzione abilitati. Per impostazione predefinita, questo cmdlet non genera alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
Breakpoint
È possibile reindirizzare un oggetto punto di interruzione a Disable-PSBreakpoint.
Output
None or System.Management.Automation.Breakpoint
Quando si utilizza il parametro PassThru , Disable-PSBreakpoint restituisce un oggetto che rappresenta il punto di interruzione disabilitato. In caso contrario, questo cmdlet non genera alcun output.