Condividi tramite

Disable-PSBreakpoint

Modulo:
Microsoft.PowerShell.Utility Module

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]
    [-Runspace <Runspace>]
    [-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

Esempio 5: Disabilitare un punto di interruzione in uno spazio di esecuzione

In questo esempio, viene avviato un processo e viene impostato un punto di interruzione per interrompere l'esecuzione quando viene eseguito il Set-PSBreakpoint. Lo spazio di esecuzione viene memorizzato in una variabile e passato al comando Get-PSBreakpoint con il parametro Runspace. L'output di Get-PSBreakpoint viene inviato tramite pipe a Disable-PSBreakpoint per disabilitare il punto di 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 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:

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

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

-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.

Proprietà dei parametri

Tipo:Runspace
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:RunspaceId

Set di parametri

Id
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
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 inviare tramite pipe un oggetto punto di interruzione a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

Breakpoint

Quando si utilizza 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