Udostępnij za pośrednictwem

Remove-PSBreakpoint

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Usuwa punkty przerwania z bieżącej konsoli.

Składnia

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSBreakpoint
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-PSBreakpoint 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 Windows PowerShell. Aby uzyskać więcej informacji na temat debugera programu Windows PowerShell, zobacz about_Debuggers.

Przykłady

Przykład 1. Usuwanie wszystkich punktów przerwania

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

To polecenie usuwa wszystkie punkty przerwania w bieżącej konsoli.

Przykład 2. Usuwanie określonego punktu przerwania

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

To polecenie usuwa punkt przerwania.

Pierwsze polecenie używa polecenia cmdlet Set-PSBreakpoint, aby utworzyć punkt przerwania w zmiennej Name w skry skry skryptu Sample.ps1. Następnie zapisuje obiekt punktu przerwania w zmiennej $B.

Drugie polecenie używa polecenia cmdlet Remove-PSBreakpoint, aby usunąć nowy punkt przerwania. Używa operatora potoku (|) do wysyłania obiektu punktu przerwania w zmiennej $B do polecenia cmdlet Remove-PSBreakpoint.

W wyniku tego polecenia po uruchomieniu skryptu zostanie uruchomiony do ukończenia bez zatrzymywania. Ponadto polecenie cmdlet Get-PSBreakpoint nie zwraca tego punktu przerwania.

Przykład 3. Usuwanie punktu przerwania według identyfikatora

PS C:\> Remove-PSBreakpoint -Id 2

To polecenie usuwa punkt przerwania z identyfikatorem punktu przerwania 2.

Przykład 4. Usuwanie wszystkich punktów przerwania za pomocą funkcji

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

Ta prosta funkcja usuwa wszystkie punkty przerwania w bieżącej konsoli. Używa on polecenia cmdlet Get-PSBreakpoint do pobierania punktów przerwania. Następnie używa operatora potoku (|) do wysyłania punktów przerwania do polecenia cmdlet Remove-PSBreakpoint, które je usuwa.

W związku z tym można wpisać del-psb zamiast dłuższego polecenia.

Aby zapisać funkcję, dodaj ją do profilu programu Windows PowerShell.

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 polecenie Get-PSBreakpoint. Można również potokować obiekty punktu przerwania do Remove-PSBreakpoint.

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

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

Breakpoint

Można potokować obiekty punktu przerwania, aby Remove-PSBreakpoint.

Dane wyjściowe

None

Polecenie cmdlet nie generuje żadnych danych wyjściowych.