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, garantendo che non vengano raggiunti durante l'esecuzione dello 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 sono abilitati per impostazione predefinita quando vengono creati utilizzando 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 numerosi cmdlet progettati per il debug degli script di Windows PowerShell. Per ulteriori informazioni sul debugger di Windows PowerShell, vedere about_Debuggers.
Esempio
Esempio 1: Impostare un punto di interruzione e disabilitarlo
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint
Questi comandi disabilitano un punto di interruzione appena creato.
Il primo comando usa il cmdlet Set-PSBreakpoint per creare un punto di interruzione sulla variabile Name nello script Sample.ps1. Quindi, salva l'oggetto punto di interruzione nella variabile $B.
Il secondo comando usa il cmdlet Disable-PSBreakpoint per disabilitare il nuovo punto di interruzione. Usa un operatore pipeline (|) per inviare l'oggetto punto di interruzione in $B al cmdlet Disable-PSBreakpoint .
Come risultato di questo comando, il valore della proprietà Enabled dell'oggetto punto di interruzione in $B è False.
Esempio 2: Disabilitare un punto di interruzione
PS C:\> Disable-PSBreakpoint -Id 0
Questo comando disabilita il punto di interruzione con ID punto di interruzione 0.
Esempio 3: Creare un punto di interruzione disabilitato
PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B
Questo comando crea un nuovo punto di interruzione disabilitato fino a quando non viene abilitato.
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, è possibile utilizzarlo come valore del parametro Breakpoint .
Il secondo comando visualizza l'oggetto punto di interruzione nel valore della variabile $B.
Esempio 4: Disabilitare tutti i punti di interruzione nella console corrente
PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint
Questo comando disabilita tutti i punti di interruzione nella console corrente. Puoi abbreviare questo comando come: "gbp | dbp".
Parametri
-Breakpoint
Specifica i punti di interruzione da disabilitare. Immettere una variabile che contiene oggetti punto di interruzione o un comando che ottiene oggetti punto di interruzione, ad esempio un comando Get-PSBreakpoint. È anche possibile reindirizzare gli oggetti punto di interruzione al cmdlet Disable-PSBreakpoint .
Proprietà dei parametri
| Tipo: | Breakpoint[] |
| 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
Specifica una matrice di ID o variabili che contiene gli ID dei punti di interruzione. Non è possibile reindirizzare 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 l'elemento con cui si sta lavorando. 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.