Remove-PSBreakpoint
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, die zum Debuggen von PowerShell-Skripts entwickelt wurden. 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 an übergeben, um Remove-PSBreakpoint
den Haltepunkt im Runspace zu 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 Breakpointobjekte an übergeben 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
Sie können Breakpointobjekte an dieses Cmdlet weiterleiten.
Int32[]
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
PowerShell enthält die folgenden Aliase für Remove-PSBreakpoint
:
- Alle Plattformen:
rbp