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