Udostępnij za pomocą

Enable-PSBreakpoint

Moduł:
Microsoft.PowerShell.Utility Module

Włącza punkty przerwania w bieżącej konsoli.

Składnia

Id (domyślnie) 

Enable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Breakpoint 

Enable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Enable-PSBreakpoint ponownie włącza wyłączone punkty przerwania. Można go użyć do włączenia wszystkich punktów przerwania lub określonych punktów przerwania, udostępniając obiekty punktu przerwania lub identyfikatory.

Punkt przerwania to punkt w skrytecie, w którym wykonywanie zatrzymuje się tymczasowo, aby można było sprawdzić stan skryptu. Nowo utworzone punkty przerwania są automatycznie włączone, ale można je wyłączyć przy użyciu Disable-PSBreakpoint.

Technicznie to polecenie cmdlet zmienia wartość właściwości Enabled obiektu punktu przerwania na True.

Enable-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. Włączanie wszystkich punktów przerwania

Ten przykład umożliwia włączenie wszystkich punktów przerwania w bieżącej sesji.

Get-PSBreakpoint | Enable-PSBreakpoint

Za pomocą aliasów ten przykład można skrócić jako gbp | ebp.

Przykład 2. Włączanie punktów przerwania według identyfikatora

W tym przykładzie można włączyć wiele punktów przerwania przy użyciu identyfikatorów punktów przerwania.

Enable-PSBreakpoint -Id 0, 1, 5

Przykład 3. Włączanie wyłączonego punktu przerwania

W tym przykładzie ponownie włączono punkt przerwania, który został wyłączony.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

tworzy punkt przerwania w zmiennej nazwa w skrybacie zapisywania obiektu punktu przerwania w zmiennej . Parametr PassThru wyświetla wartość właściwości Enabled punktu przerwania jest false.

Enable-PSBreakpoint ponownie włącza punkt przerwania. Ponownie, używając parametru PassThru, widzimy, że wartość właściwości Enabled jest True.

Przykład 4. Włączanie punktów przerwania przy użyciu zmiennej

W tym przykładzie można włączyć zestaw punktów przerwania przy użyciu obiektów punktu przerwania.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint pobiera punkty przerwania i zapisuje je w zmiennej $B. Przy użyciu parametru punktu przerwania włącza punkty przerwania.

Ten przykład jest odpowiednikiem uruchamiania Enable-PSBreakpoint -Id 3, 5.

Parametry

-Breakpoint

Określa punkty przerwania, które mają być włączone. Podaj zmienną zawierającą punkty przerwania lub polecenie, które pobiera obiekty punktu przerwania, takie jak Get-PSBreakpoint. Można również potokować obiekty punktu przerwania do Enable-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 identyfikator liczby punktów przerwania do włączenia. Wartość domyślna to wszystkie punkty przerwania. Podaj identyfikator według liczby lub zmiennej. Nie można przekazać identyfikatora liczb do Enable-PSBreakpoint. Aby znaleźć identyfikatora punktu przerwania, użyj polecenia cmdlet .

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 włączony punkt przerwania. 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 został 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 do Enable-PSBreakpoint.

Dane wyjściowe

None or System.Management.Automation.Breakpoint

Jeśli używasz parametru PassThru, Enable-PSBreakpoint zwraca obiekt punktu przerwania, który reprezentuje włączony punkt przerwania. W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Uwagi

  • Polecenie cmdlet Enable-PSBreakpoint nie generuje błędu, jeśli spróbujesz włączyć punkt przerwania, który jest już włączony. W związku z tym można włączyć wszystkie punkty przerwania bez błędów, nawet jeśli tylko kilka z nich jest wyłączonych.

  • Punkty przerwania są włączane podczas ich tworzenia przy użyciu polecenia cmdlet Set-PSBreakpoint. Nie musisz włączać nowo utworzonych punktów przerwania.