Remove-PSBreakpoint

  • Referens
Modul:
Microsoft.PowerShell.Utility

Tar bort brytpunkter från den aktuella konsolen.

Syntax

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

Description

Cmdleten Remove-PSBreakpoint tar bort en brytpunkt. Ange ett brytpunktsobjekt eller ett brytpunkts-ID.

När du tar bort en brytpunkt är brytpunktsobjektet inte längre tillgängligt eller funktionellt. Om du har sparat ett brytpunktsobjekt i en variabel finns referensen fortfarande, men brytpunkten fungerar inte.

Remove-PSBreakpoint är en av flera cmdletar som är utformade för felsökning av Windows PowerShell-skript. Mer information om Windows PowerShell-felsökningsprogrammet finns i about_Debuggers.

Exempel

Exempel 1: Ta bort alla brytpunkter

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

Det här kommandot tar bort alla brytpunkter i den aktuella konsolen.

Exempel 2: Ta bort en angiven brytpunkt

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

Det här kommandot tar bort en brytpunkt.

Det första kommandot använder cmdleten Set-PSBreakpoint för att skapa en brytpunkt för variabeln Namn i skriptet Sample.ps1. Sedan sparas brytpunktsobjektet i variabeln $B.

Det andra kommandot använder cmdleten Remove-PSBreakpoint för att ta bort den nya brytpunkten. Den använder en pipelineoperator (|) för att skicka brytpunktsobjektet i $B-variabeln till cmdleten Remove-PSBreakpoint.

Som ett resultat av det här kommandot, om du kör skriptet, körs det till slutförande utan att stoppa. Dessutom returnerar cmdleten Get-PSBreakpoint inte den här brytpunkten.

Exempel 3: Ta bort en brytpunkt efter ID

PS C:\> Remove-PSBreakpoint -Id 2

Det här kommandot tar bort brytpunkten med brytpunkts-ID 2.

Exempel 4: Använd en funktion för att ta bort alla brytpunkter

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

Den här enkla funktionen tar bort alla brytpunkter i den aktuella konsolen. Den använder cmdleten Get-PSBreakpoint för att hämta brytpunkterna. Sedan använder den en pipelineoperator (|) för att skicka brytpunkterna till cmdleten Remove-PSBreakpoint som tar bort dem.

Därför kan du skriva del-psb i stället för det längre kommandot.

Spara funktionen genom att lägga till den i din Windows PowerShell-profil.

Parametrar

-Breakpoint

Anger brytpunkterna som ska tas bort. Ange en variabel som innehåller brytpunktsobjekt eller ett kommando som hämtar brytpunktsobjekt, till exempel ett Kommandot Get-PSBreakpoint. Du kan också skicka brytpunktsobjekt till Remove-PSBreakpoint.

Typ:Breakpoint[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger brytpunkts-ID som den här cmdleten tar bort brytpunkter för.

Typ:Int32[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

Breakpoint

Du kan skicka brytpunktsobjekt till Remove-PSBreakpoint.

Utdata

None

Cmdleten genererar inga utdata.