Remove-PSBreakpoint

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Löscht Haltepunkte aus der aktuellen Konsole.

Syntax

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

Beschreibung

Das Remove-PSBreakpoint Cmdlet löscht einen Haltepunkt. Geben Sie ein Haltepunktobjekt oder eine Haltepunkt-ID ein.

Beim Entfernen eines Haltepunkts ist das Haltepunktobjekt nicht mehr verfügbar oder funktioniert nicht mehr. Wenn Sie ein Haltepunktobjekt in einer Variablen gespeichert haben, ist der Verweis noch vorhanden, der Haltepunkt funktioniert jedoch nicht mehr.

Remove-PSBreakpoint ist eines von mehreren Cmdlets zum Debuggen von PowerShell-Skripts. Weitere Informationen zum PowerShell-Debugger finden Sie unter about_Debuggers.

Beispiele

Beispiel 1: Entfernen aller Haltepunkte

Dieser Befehl löscht alle Haltepunkte in der aktuellen Konsole.

Get-PSBreakpoint | Remove-PSBreakpoint

Beispiel 2: Entfernen eines angegebenen Haltepunkts

Dieser Befehl löscht einen Haltepunkt.

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

Das Set-PSBreakpoint Cmdlet erstellt einen Haltepunkt für die $Name Variable im Sample.ps1 Skript und speichert das Haltepunktobjekt in der $B Variablen. Das Remove-PSBreakpoint Cmdlet löscht den neuen Haltepunkt. Es verwendet einen Pipelineoperator (|), um das Haltepunktobjekt in der $B Variablen an das Remove-PSBreakpoint Cmdlet zu senden.

Als Ergebnis dieses Befehls wird das Skript bei der Ausführung nicht angehalten. Außerdem gibt das Get-PSBreakpoint Cmdlet diesen Haltepunkt nicht zurück.

Beispiel 3: Entfernen eines Haltepunkts nach ID

Dieser Befehl löscht den Haltepunkt mit der Haltepunkt-ID 2.

Remove-PSBreakpoint -Id 2

Beispiel 4: Verwenden einer Funktion zum Entfernen aller Haltepunkte

Diese einfache Funktion löscht alle Haltepunkte in der aktuellen Sitzung.

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

Es verwendet das Get-PSBreakpoint Cmdlet, um die Haltepunkte abzurufen. Anschließend wird ein Pipelineoperator (|) verwendet, um die Haltepunkte an das Remove-PSBreakpoint Cmdlet zu senden, wodurch sie gelöscht werden.

Beispiel 5: Entfernen eines Haltepunkts in einem Runspace

In diesem Beispiel wird ein Auftrag gestartet und ein Haltepunkt ist für die Ausführung des Set-PSBreakPoint festgelegt. Der Runspace wird in einer Variablen gespeichert und mit dem Runspace-Parameter an den Get-PSBreakPoint-Befehl übergeben. Die Ausgabe von Get-PSBreakPoint wird weitergeleitet, um den Haltepunkt im Runspace zu Remove-PSBreakpoint entfernen.

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

Parameter

-Breakpoint

Gibt die zu löschenden Haltepunkte an. Geben Sie eine Variable ein, die Haltepunktobjekte enthält, oder einen Befehl, der Haltepunktobjekte abruft, z. B. einen Get-PSBreakpoint Befehl. Sie können auch Haltepunktobjekte an Remove-PSBreakpoint.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Id

Gibt Haltepunkt-IDs an, für die dieses Cmdlet Haltepunkte löscht.

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

-Runspace

Gibt die ID eines Runspace-Objekts an, damit Sie mit Haltepunkten im angegebenen Runspace interagieren können.

Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Breakpoint[]

Sie können Haltepunktobjekte an dieses Cmdlet weiterleiten.

Int32[]

Runspace

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Remove-PSBreakpoint:

  • Alle Plattformen:
    • rbp