Condividi tramite

Disable-PSBreakpoint

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Disabilita i punti di interruzione nella console corrente.

Sintassi

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-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 è 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 cmdlet Enable-PSBreakpoint. I punti di interruzioni vengono abilitati per impostazione predefinita quando si creano con il cmdlet Set-PSBreakpoint.

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 di script Windows PowerShell. Per altre 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 nella variabile Name nello script Sample.ps1. Salva quindi 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 .

In seguito a 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 0.

Esempio 3: Create 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 che rimane disabilitato finché 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 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, poiché Set-PSBreakpoint genera un oggetto punto di interruzione, può essere usato come valore del parametro Punto di interruzione .

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. È possibile abbreviare questo comando come: "gbp | dbp".

Parametri

-Breakpoint

Specifica i punti di interruzione da disabilitare. Immettere una variabile che contiene gli oggetti punto di interruzione o un comando che ottiene tali oggetti, ad esempio un comando Get-PSBreakpoint. È anche possibile inviare tramite pipe oggetti punto di interruzione al cmdlet Disable-PSBreakpoint .

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

Specifica una matrice di ID o variabili che contiene gli ID dei punti di interruzione. Non è possibile inviare tramite pipe GLI ID 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 l'elemento in uso. 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

-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

Breakpoint

È possibile inviare tramite pipe 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, il cmdlet non genera alcun output.