Condividi tramite

Remove-PSBreakpoint

Modulo:
Microsoft.PowerShell.Utility Module

Elimina i punti di interruzione dalla console corrente.

Sintassi

Breakpoint (impostazione predefinita). 

Remove-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id 

Remove-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Remove-PSBreakpoint elimina un punto di interruzione. Immettere un oggetto punto di interruzione o un ID punto di interruzione.

Quando si rimuove un punto di interruzione, l'oggetto punto di interruzione non è più disponibile o funzionale. Se è stato salvato un oggetto punto di interruzione in una variabile, il riferimento esiste ancora, ma il punto di interruzione non funziona.

Remove-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: Rimuovere tutti i punti di interruzione

Questo comando elimina tutti i punti di interruzione nella console corrente.

Get-PSBreakpoint | Remove-PSBreakpoint

Esempio 2: Rimuovere un punto di interruzione specificato

Questo comando elimina un punto di interruzione.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-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 Remove-PSBreakpoint elimina il nuovo punto di interruzione. Usa un operatore pipeline (|) per inviare l'oggetto del punto di interruzione dalla variabile $B al cmdlet Remove-PSBreakpoint.

In seguito a questo comando, se si esegue lo script, viene eseguito fino al completamento senza arrestarsi. Inoltre, il cmdlet Get-PSBreakpoint non restituisce questo punto di interruzione.

Esempio 3: Rimuovere un punto di interruzione in base all'ID

Questo comando elimina il punto di interruzione con ID 2.

Remove-PSBreakpoint -Id 2

Esempio 4: Usare una funzione per rimuovere tutti i punti di interruzione

Questa semplice funzione elimina tutti i punti di interruzione nella sessione corrente.

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

Usa il cmdlet Get-PSBreakpoint per ottenere i punti di interruzione. Usa quindi un operatore pipeline (|) per inviare i punti di interruzione al cmdlet Remove-PSBreakpoint, che li elimina.

Esempio 5: Rimuovere 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 Remove-PSBreakpoint per rimuovere 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 | Remove-Breakpoint -Runspace $runspace

Parametri

-Breakpoint

Specifica i punti di interruzione da eliminare. 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 trasmettere oggetti di punto di interruzione a Remove-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 gli ID dei punti di interruzione per cui questo cmdlet li elimina.

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

-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 oggetti punto di interruzione a questo cmdlet.

Int32

Runspace

Output

None

Questo cmdlet non restituisce alcun output.

Note

PowerShell include gli alias seguenti per Remove-PSBreakpoint:

  • Tutte le piattaforme:
    • rbp