Disable-PSBreakpoint
Disabilita i punti di interruzione nella console corrente.
Sintassi
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il Disable-PSBreakpoint
cmdlet disabilita i punti di interruzione, che assicurano che non vengano raggiunti quando lo script viene eseguito. È possibile usarlo per disabilitare tutti i punti di interruzione oppure è possibile specificare i punti di interruzione tramite l'invio di oggetti punto di interruzione o ID dei punti di interruzione.
Tecnicamente, questo cmdlet modifica il valore della proprietà Enabled di un oggetto punto di interruzione impostandolo su False.
Per riabilitare un punto di interruzione, usare il Enable-PSBreakpoint
cmdlet. I punti di interruzione vengono abilitati per impostazione predefinita quando vengono creati usando il Set-PSBreakpoint
cmdlet.
Un punto di interruzione è un punto in uno script in cui l'esecuzione viene interrotta temporaneamente per consentire l'analisi delle istruzioni nello script. Disable-PSBreakpoint
è uno dei diversi cmdlet progettati per il debug degli 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 Set-PSBreakpoint
cmdlet crea un punto di interruzione nella $Name
variabile nello Sample.ps1
script e salva l'oggetto punto di interruzione nella $B
variabile. Il Disable-PSBreakpoint
cmdlet disabilita il nuovo punto di interruzione. Usa un operatore pipeline (|
) per inviare l'oggetto Disable-PSBreakpoint
punto di interruzione al $B
cmdlet.
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
Questo comando disabilita il punto di interruzione con ID 0.
Disable-PSBreakpoint -Id 0
Esempio 3: Create un punto di interruzione disabilitato
Questo comando crea un nuovo punto di interruzione che rimane disabilitato finché non viene abilitato.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
Usa il cmdlet per disabilitare il Disable-PSBreakpoint
punto di interruzione. Il valore del parametro Punto di interruzione è un Set-PSBreakpoint
comando che imposta un nuovo punto di interruzione, genera un oggetto punto di interruzione e salva l'oggetto nella $B
variabile.
I parametri dei 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, perché 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
Esempio 5: Disabilitare un punto di interruzione in un runspace
In questo esempio viene avviato un processo e viene impostato un punto di interruzione per interrompere l'esecuzione quando viene eseguito Set-PSBreakPoint
. Lo spazio di esecuzione viene archiviato in una variabile e passato al comando Get-PSBreakPoint
con il parametro Runspace. L'output di viene eseguito tramite pipe per Disable-PSBreakpoint
disabilitare il punto di Get-PSBreakPoint
interruzione nello spazio di esecuzione.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace
Parametri
-Breakpoint
Specifica i punti di interruzione da disabilitare. Immettere una variabile contenente oggetti punto di interruzione o un comando che ottiene oggetti punto di interruzione, ad esempio un Get-PSBreakpoint
comando. È anche possibile inviare oggetti di punto di interruzione pipe al Disable-PSBreakpoint
cmdlet.
Type: | Breakpoint[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Disabilita i punti di interruzione con gli ID specificati. Immettere gli ID o una variabile che li contiene. Non è possibile inviare ID pipe a Disable-PSBreakpoint
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Restituisce un oggetto che rappresenta i punti di interruzione abilitati. Per impostazione predefinita, il cmdlet non genera alcun output.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Runspace
Specifica l'ID di un oggetto Runspace in modo da poter interagire con i punti di interruzione nello spazio di esecuzione specificato.
Questo parametro è stato aggiunto in PowerShell 7.2.
Type: | Runspace |
Aliases: | RunspaceId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare un oggetto punto di interruzione a questo cmdlet.
Output
None
Per impostazione predefinita, questo cmdlet non restituisce alcun output.
Quando si usa il parametro PassThru , questo cmdlet restituisce un oggetto punto di interruzione che rappresenta il punto di interruzione disabilitato.
Note
PowerShell include gli alias seguenti per Disable-PSBreakpoint
:
- Tutte le piattaforme:
dbp