Disable-PSBreakpoint
Wyłącza punkty przerwania w bieżącej konsoli.
Składnia
Breakpoint (domyślnie)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Disable-PSBreakpoint wyłącza punkty przerwania, co gwarantuje, że nie zostaną one trafione po uruchomieniu skryptu. Można jej użyć do wyłączenia wszystkich punktów przerwania lub określić punkty przerwania, przesyłając obiekty punktu przerwania lub identyfikatory punktów przerwania.
Technicznie to polecenie cmdlet zmienia wartość właściwości Enabled obiektu punktu przerwania na False. Aby ponownie włączyć punkt przerwania, użyj polecenia cmdlet Enable-PSBreakpoint. Punkty przerwania są domyślnie włączone podczas ich tworzenia przy użyciu polecenia cmdlet Set-PSBreakpoint.
Punkt przerwania to punkt w skrytecie, w którym wykonywanie zostaje tymczasowo zatrzymane, aby można było sprawdzić instrukcje w skry skrycie. Disable-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: Ustawianie punktu przerwania i wyłączanie go
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint
Te polecenia wyłączają nowo utworzony punkt przerwania.
Pierwsze polecenie używa polecenia cmdlet Set-PSBreakpoint do utworzenia punktu przerwania w zmiennej nazwa
Drugie polecenie używa polecenia cmdlet Disable-PSBreakpoint, aby wyłączyć nowy punkt przerwania. Używa operatora potoku (|) do wysyłania obiektu punktu przerwania w $B do polecenia cmdlet Disable-PSBreakpoint.
W wyniku tego polecenia wartość właściwości Enabled obiektu punktu przerwania w $B ma wartość False.
Przykład 2. Wyłączanie punktu przerwania
PS C:\> Disable-PSBreakpoint -Id 0
To polecenie wyłącza punkt przerwania z identyfikatorem punktu przerwania 0.
Przykład 3. Tworzenie wyłączonego punktu przerwania
PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B
To polecenie tworzy nowy punkt przerwania, który jest wyłączony do momentu jej włączenia.
Używa polecenia cmdlet Disable-PSBreakpoint, aby wyłączyć punkt przerwania.
Wartość parametru punktu przerwania
Parametry polecenia cmdlet, które przyjmują obiekty jako ich wartości, mogą akceptować zmienną zawierającą obiekt lub polecenie, które pobiera lub generuje obiekt.
W tym przypadku, ponieważ
Drugie polecenie wyświetla obiekt punktu przerwania w wartości zmiennej $B.
Przykład 4. Wyłączanie wszystkich punktów przerwania w bieżącej konsoli
PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint
To polecenie wyłącza wszystkie punkty przerwania w bieżącej konsoli. To polecenie można skrócić w następujący sposób: "gbp | dbp".
Parametry
-Breakpoint
Określa punkty przerwania do wyłączenia. 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 polecenia cmdlet Disable-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ązkowe: | 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ązkowe: | 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 tablicę identyfikatorów lub zmiennych, które zawierają identyfikatory punktów przerwania. Nie można potokować identyfikatorów do Disable-PSBreakpoint.
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ązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| 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ązkowe: | 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
Obiekt punktu przerwania można przekazać potokiem, aby Disable-PSBreakpoint.
Dane wyjściowe
None or System.Management.Automation.Breakpoint
Jeśli używasz parametru PassThru, Disable-PSBreakpoint zwraca obiekt reprezentujący wyłączony punkt przerwania. W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.