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[]>
      [-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 $BRemove-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-PSBreakpointelementu .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Określa identyfikatory punktów przerwania, dla których to polecenie cmdlet usuwa punkty przerwania.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

Breakpoint[]

Do tego polecenia cmdlet można potokować obiekty punktu przerwania.

Int32[]

Runspace

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