Condividi tramite

Remove-PSBreakpoint

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Elimina i punti di interruzione dalla console corrente.

Sintassi

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

Descrizione

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

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

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 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 Remove-PSBreakpoint cmdlet elimina il nuovo punto di interruzione. Usa un operatore pipeline (|) per inviare l'oggetto punto di interruzione nella $B variabile al Remove-PSBreakpoint cmdlet .

Come conseguenza di questo comando, se si esegue lo script, questo verrà eseguito fino al completamento senza interruzioni. Inoltre, il Get-PSBreakpoint cmdlet 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 Get-PSBreakpoint cmdlet per ottenere i punti di interruzione. Usa quindi un operatore pipeline (|) per inviare i punti di interruzione al Remove-PSBreakpoint cmdlet , 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 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 Remove-PSBreakpoint per rimuovere 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 | 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 ottiene oggetti punto di interruzione, ad esempio un Get-PSBreakpoint comando. È anche possibile inviare tramite pipe oggetti punto di interruzione a Remove-PSBreakpoint.

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

Specifica gli ID punto di interruzione per cui questo cmdlet elimina i punti di interruzione.

Tipo:Int32[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
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 oggetti punto di interruzione a questo cmdlet.

Int32[]

Runspace

Output

None

Questo cmdlet non restituisce output.

Note

PowerShell include gli alias seguenti per Remove-PSBreakpoint:

  • Tutte le piattaforme:
    • rbp