Freigeben über

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[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-PSBreakpoint 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, die zum Debuggen von PowerShell-Skripts entwickelt wurden. Weitere Informationen zum PowerShell-Debugger finden Sie unter about_Debuggers.

Beispiele

Beispiel 1: Entfernen aller Haltepunkte

PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint

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

Beispiel 2: Entfernen eines angegebenen Haltepunkts

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint

Dieser Befehl löscht einen Haltepunkt.

Der erste Befehl verwendet das Set-PSBreakpoint-Cmdlet, um einen Haltepunkt für die Name-Variable im Skript „Sample.ps1“ zu erstellen. Anschließend wird das Haltepunktobjekt in der variablen $B gespeichert.

Der zweite Befehl verwendet das Cmdlet Remove-PSBreakpoint , um den neuen Haltepunkt zu löschen. Es verwendet einen Pipelineoperator (|), um das Haltepunktobjekt in der $B Variable an das Cmdlet Remove-PSBreakpoint zu senden.

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

Beispiel 3: Entfernen eines Haltepunkts nach ID

PS C:\> Remove-PSBreakpoint -Id 2

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

Beispiel 4: Verwenden einer Funktion zum Entfernen aller Haltepunkte

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

Diese einfache Funktion löscht alle Haltepunkte in der aktuellen Konsole. Die Funktion verwendet das Get-PSBreakpoint-Cmdlet, um die Haltepunkte abzurufen. Anschließend wird ein Pipelineoperator (|) verwendet, um die Haltepunkte an das Cmdlet Remove-PSBreakpoint zu senden, das sie löscht.

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

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

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 Breakpointobjekte an Remove-PSBreakpoint übergeben.

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

-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 Breakpointobjekte an Remove-PSBreakpoint übergeben.

Ausgaben

None

Das Cmdlet generiert keine Ausgabe.