Udostępnij za pomocą

Remove-PSBreakpoint

Moduł:
Microsoft.PowerShell.Utility Module

Usuwa punkty przerwania z bieżącej konsoli.

Składnia

Breakpoint (Domyślna) 

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

Id 

Remove-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [-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 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 cmdlet Set-PSBreakpoint tworzy punkt przerwania w zmiennej $Name skryptu Sample.ps1 i zapisuje obiekt punktu przerwania w zmiennej $B. Polecenie cmdlet Remove-PSBreakpoint usuwa 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

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 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.

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 polecenia Get-PSBreakpoint za pomocą parametru Runspace. Dane wyjściowe Get-PSBreakpoint są przesyłane potokami do Remove-PSBreakpoint w celu 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 polecenia. Można również potokować obiekty punktu przerwania do Remove-PSBreakpoint.

Właściwości parametru

Typ:

Breakpoint[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Breakpoint
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

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

Właściwości parametru

Typ:

Int32[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Id
Position:0
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Runspace
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator elementu RunspaceId

Zestawy parametrów

Id
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

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 Remove-PSBreakpoint:

  • Wszystkie platformy:
    • rbp