Löscht Haltepunkte aus der aktuellen Konsole.

Syntax

Remove-PSBreakpoint [-Id] <Int32[]> [-Bestätigung] [-WhatIf] [<CommonParameters>]

Remove-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-Bestätigung] [-WhatIf] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Remove-PSBreakpoint" wird ein Haltepunkt gelöscht. Geben Sie ein Haltepunktobjekt oder eine Haltepunkt-ID ein.

Wenn Sie einen Haltepunkt entfernen, ist das Haltepunktobjekt nicht mehr verfügbar oder funktionsfähig. Wenn Sie ein Haltepunktobjekt in einer Variablen gespeichert haben, ist der Verweis noch vorhanden, jedoch ist der Haltepunkt ohne Funktion.

Remove-PSBreakpoint ist eines von mehreren Cmdlets zum Debuggen von Windows PowerShell-Skripten. Weitere Informationen über den Windows PowerShell-Debugger finden Sie unter "about_Debuggers".

Parameter

-Breakpoint <Breakpoint[]>

Gibt die zu löschenden Haltepunkte an. Geben Sie eine Variable ein, die Haltepunktobjekte enthält, oder einen Befehl zum Abrufen von Haltepunktobjekten, z. B. den Befehl "Get-PSBreakpoint". Sie können Haltepunktobjekte auch über die Pipeline an Remove-PSBreakpoint übergeben.

Erforderlich?

true

Position?

1

Standardwert

keine

Pipelineeingaben akzeptieren?

true (ByValue)

Platzhalterzeichen akzeptieren?

false

-Id <Int32[]>

Löscht die Haltepunkte mit den angegebenen Haltepunkt-IDs.

Erforderlich?

true

Position?

1

Standardwert

keine

Pipelineeingaben akzeptieren?

true (ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-Bestätigung

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.Management.Automation.Breakpoint

Sie können Haltepunktobjekte auch über die Pipeline an Remove-PSBreakpoint übergeben.

Ausgaben

None

Das Cmdlet generiert keine Ausgabe.

Beispiel 1

C:\PS>get-breakpoint | remove-breakpoint

Beschreibung
-----------
Mit diesem Befehl werden alle Haltepunkte in der aktuellen Konsole gelöscht.






Beispiel 2

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | remove-psbreakpoint

Beschreibung
-----------
Mit diesem Befehl wird ein Haltepunkt gelöscht.

Im ersten Befehl wird ein Haltepunkt für die Variable "Name" im Skript "Sample.ps1" mit dem Cmdlet "Set-PSBreakpoint" erstellt. Dann wird das Haltepunktobjekt in der Variablen "$b" gespeichert.

Im zweiten Befehl wird der neue Haltepunkt mit dem Cmdlet "Remove-PSBreakpoint" gelöscht. Das Haltepunktobjekt in der Variablen "$b" wird mit dem Pipelineoperator (|) an das Cmdlet "Remove-PSBreakpoint" gesendet.

Dieser Befehl wirkt, dass das Skript während der Ausführung nicht angehalten wird. Außerdem gibt das Cmdlet "Get-PSBreakpoint" diesen Haltepunkt nicht zurück.






Beispiel 3

C:\PS>remove-psbreakpoint -id 2

Beschreibung
-----------
Mit diesem Befehl wird der Haltepunkt mit der Haltepunkt-ID 2 gelöscht.






Beispiel 4

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

Beschreibung
-----------
Mit dieser einfachen Funktion werden alle Haltepunkte in der aktuellen Konsole gelöscht. Die Haltepunkte werden mit dem Cmdlet "Get-PSBreakpoint" abgerufen. Dann werden die Haltepunkte mithilfe eines Pipelineoperators (|) an das Cmdlet "Remove-PSBreakpoint" gesendet, das sie löscht. 

Daher können Sie statt des längeren Befehls "del-psb" eingeben.

Um die Funktion zu speichern, fügen Sie sie dem Windows PowerShell-Profil hinzu.






Siehe auch




Inhaltsverzeichnis