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[]>
       [-Runspace <Runspace>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Descrizione

Il Disable-PSBreakpoint cmdlet 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 Enable-PSBreakpoint cmdlet . I punti di interruzione sono 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 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 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 punto di interruzione al $B Disable-PSBreakpoint cmdlet .

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

Disable-PSBreakpoint -Id 0

Esempio 3: Creare 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 Disable-PSBreakpoint cmdlet per disabilitare il 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, 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 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 inviato tramite pipe a Disable-PSBreakpoint per 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 tramite pipe oggetti punto di interruzione al Disable-PSBreakpoint cmdlet .

Tipo:Breakpoint[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Disabilita i punti di interruzione con gli ID specificati. Immettere gli ID o una variabile che li contiene. Non è possibile inviare tramite pipe gli ID a Disable-PSBreakpoint.

Tipo:Int32[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta i punti di interruzione abilitati. Per impostazione predefinita, il cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Runspace
Alias:RunspaceId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

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