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

Descrizione

Il cmdlet Remove-PSBreakpoint 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 Windows PowerShell. Per altre informazioni sul debugger di Windows PowerShell, vedere about_Debuggers.

Esempio

Esempio 1: Rimuovere tutti i punti di interruzione

PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint

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

Esempio 2: Rimuovere un punto di interruzione specificato

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint

Questo comando elimina un punto di interruzione.

Il primo comando usa il cmdlet Set-PSBreakpoint per creare un punto di interruzione in corrispondenza della variabile Name nello script Sample.ps1. Salva quindi l'oggetto punto di interruzione nella variabile $B.

Il secondo comando usa il cmdlet Remove-PSBreakpoint per eliminare il nuovo punto di interruzione. Usa un operatore pipeline (|) per inviare l'oggetto punto di interruzione nella variabile $B al cmdlet Remove-PSBreakpoint .

Come conseguenza di questo comando, se si esegue lo script, questo verrà eseguito fino al completamento senza interruzioni. Inoltre, il cmdlet Get-PSBreakpoint non restituisce questo punto di interruzione.

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

PS C:\> Remove-PSBreakpoint -Id 2

Questo comando elimina il punto di interruzione con ID 2.

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

PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }

Questa semplice funzione elimina tutti i punti di interruzione nella console corrente. 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.

Di conseguenza, è possibile digitare del-psb anziché il comando più lungo.

Per salvare la funzione, aggiungerla al profilo di Windows PowerShell.

Parametri

-Breakpoint

Specifica i punti di interruzione da eliminare. Immettere una variabile che contiene oggetti punto di interruzione o un comando che ottiene oggetti punto di interruzione, ad esempio un comando Get-PSBreakpoint . È anche possibile inviare tramite pipe oggetti punto di interruzione a Remove-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 gli ID dei punti di interruzione per i quali questo cmdlet elimina i punti di interruzione.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
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 oggetti punto di interruzione a Remove-PSBreakpoint.

Output

None

Il cmdlet non genera alcun output.