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[]>
      [-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 skriptet Sample.ps1 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 ställs in på att brytas när det Set-PSBreakPoint körs. Runspace lagras i en variabel och skickas Get-PSBreakPoint till kommandot med parametern Runspace . Utdata Get-PSBreakPoint från skickas till för att Remove-PSBreakpoint ta bort brytpunkten i runspace.

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.

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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