Dela via


Remove-PSBreakpoint

Tar bort brytpunkter från den aktuella konsolen.

Syntax

Breakpoint (Standard)

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

Id

Remove-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [-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 PowerShell-skript. Mer information om PowerShell-felsökningsprogrammet finns i about_Debuggers.

Exempel

Exempel 1: Ta bort alla brytpunkter

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

Get-PSBreakpoint | Remove-PSBreakpoint

Exempel 2: Ta bort en angiven brytpunkt

Det här kommandot tar bort en brytpunkt.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint

Cmdleten Set-PSBreakpoint skapar en brytpunkt för variabeln $Name i Sample.ps1-skriptet och sparar brytpunktsobjektet i variabeln $B. Cmdleten Remove-PSBreakpoint tar bort den nya brytpunkten. Den använder en pipelineoperator (|) för att skicka brytpunktsobjektet i variabeln $B 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. Cmdleten Get-PSBreakpoint returnerar inte heller den här brytpunkten.

Exempel 3: Ta bort en brytpunkt efter ID

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

Remove-PSBreakpoint -Id 2

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

Den här enkla funktionen tar bort alla brytpunkter i den aktuella sessionen.

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

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.

Exempel 5: Ta bort en brytpunkt i ett runspace

I det här exemplet startas ett jobb och en brytpunkt anges att brytas när Set-PSBreakpoint körs. Runspace lagras i en variabel och skickas till kommandot Get-PSBreakpoint med parametern Runspace. Utdata från Get-PSBreakpoint skickas till Remove-PSBreakpoint för att ta bort brytpunkten i körningsutrymmet.

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

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 Get-PSBreakpoint kommando. Du kan också skicka brytpunktsobjekt till Remove-PSBreakpoint.

Parameteregenskaper

Typ:

Breakpoint[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Breakpoint
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

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

Parameteregenskaper

Typ:

Int32[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Id
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Runspace

Anger ID för ett Runspace- objekt så att du kan interagera med brytpunkter i det angivna körningsutrymmet.

Den här parametern lades till i PowerShell 7.2.

Parameteregenskaper

Typ:Runspace
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RunspaceId

Parameteruppsättningar

Id
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

Breakpoint

Du kan skicka brytpunktsobjekt till den här cmdleten.

Int32

Runspace

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

PowerShell innehåller följande alias för Remove-PSBreakpoint:

  • Alla plattformar:
    • rbp