Remove-PSBreakpoint
Usuwa punkty przerwania z bieżącej konsoli.
Składnia
Remove-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSBreakpoint
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie Remove-PSBreakpoint
cmdlet usuwa punkt przerwania. Wprowadź obiekt punktu przerwania lub identyfikator punktu przerwania.
Po usunięciu punktu przerwania obiekt punktu przerwania nie jest już dostępny ani funkcjonalny. Jeśli obiekt punktu przerwania został zapisany w zmiennej, odwołanie nadal istnieje, ale punkt przerwania nie działa.
Remove-PSBreakpoint
jest jednym z kilku poleceń cmdlet przeznaczonych do debugowania skryptów programu PowerShell. Aby uzyskać więcej informacji na temat debugera programu PowerShell, zobacz about_Debuggers.
Przykłady
Przykład 1. Usuwanie wszystkich punktów przerwania
To polecenie usuwa wszystkie punkty przerwania w bieżącej konsoli.
Get-PSBreakpoint | Remove-PSBreakpoint
Przykład 2. Usuwanie określonego punktu przerwania
To polecenie usuwa punkt przerwania.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint
Polecenie Set-PSBreakpoint
cmdlet tworzy punkt przerwania dla $Name
zmiennej w skry skryptzie Sample.ps1
i zapisuje obiekt punktu przerwania w zmiennej $B
. Polecenie Remove-PSBreakpoint
cmdlet usuwa nowy punkt przerwania. Używa operatora potoku (|
) do wysyłania obiektu punktu przerwania w zmiennej $B
Remove-PSBreakpoint
do polecenia cmdlet.
W wyniku tego polecenia po uruchomieniu skryptu zostanie uruchomiony do ukończenia bez zatrzymywania. Ponadto polecenie Get-PSBreakpoint
cmdlet nie zwraca tego punktu przerwania.
Przykład 3. Usuwanie punktu przerwania według identyfikatora
To polecenie usuwa punkt przerwania z identyfikatorem punktu przerwania 2.
Remove-PSBreakpoint -Id 2
Przykład 4. Usuwanie wszystkich punktów przerwania za pomocą funkcji
Ta prosta funkcja usuwa wszystkie punkty przerwania w bieżącej sesji.
function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }
Używa Get-PSBreakpoint
polecenia cmdlet do pobierania punktów przerwania. Następnie używa operatora potoku (|
) do wysyłania punktów przerwania do Remove-PSBreakpoint
polecenia cmdlet, które je usuwa.
Przykład 5. Usuwanie punktu przerwania w przestrzeni uruchomieniowej
W tym przykładzie zadanie jest uruchamiane, a punkt przerwania jest ustawiony na przerwanie po uruchomieniu Set-PSBreakPoint
. Przestrzeń uruchomieniowa jest przechowywana w zmiennej i przekazywana do Get-PSBreakPoint
polecenia za pomocą parametru Runspace . Dane wyjściowe elementu Get-PSBreakPoint
są przesyłane potokami w celu Remove-PSBreakpoint
usunięcia punktu przerwania w przestrzeni uruchomieniowej.
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
Parametry
-Breakpoint
Określa punkty przerwania do usunięcia. Wprowadź zmienną zawierającą obiekty punktu przerwania lub polecenie, które pobiera obiekty punktu przerwania, takie jak Get-PSBreakpoint
polecenie. Można również potokować obiekty punktu przerwania do Remove-PSBreakpoint
elementu .
Typ: | Breakpoint[] |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Id
Określa identyfikatory punktów przerwania, dla których to polecenie cmdlet usuwa punkty przerwania.
Typ: | Int32[] |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Runspace
Określa identyfikator obiektu Runspace , aby można było wchodzić w interakcje z punktami przerwania w określonej przestrzeni uruchomieniowej.
Ten parametr został dodany w programie PowerShell 7.2.
Typ: | Runspace |
Aliasy: | RunspaceId |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Do tego polecenia cmdlet można potokować obiekty punktu przerwania.
Int32[]
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Program PowerShell zawiera następujące aliasy dla programu Remove-PSBreakpoint
:
- Wszystkie platformy:
rbp