Get-PSBreakpoint
Pobiera punkty przerwania ustawione w bieżącej sesji.
Składnia
Line (Domyślna)
Get-PSBreakpoint
[[-Script] <String[]>]
[-Runspace <Runspace>]
[<CommonParameters>]
Command
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Variable
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Id
Get-PSBreakpoint
[-Id] <Int32[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Opis
Polecenie cmdlet Get-PSBreakpoint pobiera punkty przerwania ustawione w bieżącej sesji. Możesz użyć parametrów polecenia cmdlet, aby uzyskać określone punkty przerwania.
Punkt przerwania to punkt w poleceniu lub skrycie, w którym wykonywanie jest tymczasowo zatrzymywane, aby można było sprawdzić instrukcje.
Get-PSBreakpoint jest jednym z kilku poleceń cmdlet przeznaczonych do debugowania skryptów i poleceń programu PowerShell. Aby uzyskać więcej informacji na temat debugera programu PowerShell, zobacz about_Debuggers.
Przykłady
Przykład 1. Pobieranie wszystkich punktów przerwania dla wszystkich skryptów i funkcji
To polecenie pobiera wszystkie punkty przerwania ustawione na wszystkich skryptach i funkcjach w bieżącej sesji.
Get-PSBreakpoint
Przykład 2. Pobieranie punktów przerwania według identyfikatora
To polecenie pobiera punkt przerwania z identyfikatorem punktu przerwania 2.
Get-PSBreakpoint -Id 2
Function :
IncrementAction :
Enabled :
TrueHitCount : 0
Id : 2
Script : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1
Przykład 3. Potok identyfikatora do polecenia "Get-PSBreakpoint"
Te polecenia pokazują, jak uzyskać punkt przerwania przez potokowanie identyfikatora punktu przerwania w celu Get-PSBreakpoint.
$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint
Polecenie cmdlet Set-PSBreakpoint tworzy punkt przerwania w funkcji Increment w skrycie Sample.ps1 i zapisuje obiekt punktu przerwania w zmiennej $B. Właściwość Id obiektu punktu przerwania w zmiennej $B jest potokowa do polecenia cmdlet Get-PSBreakpoint w celu wyświetlenia informacji o punkcie przerwania.
Przykład 4. Pobieranie punktów przerwania w określonych plikach skryptów
To polecenie pobiera wszystkie punkty przerwania w plikach Sample.ps1 i SupportScript.ps1.
Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"
To polecenie nie pobiera innych punktów przerwania, które mogą być ustawione w innych skryptach lub na funkcjach w sesji.
Przykład 5. Pobieranie punktów przerwania w określonych poleceniach cmdlet
To polecenie pobiera wszystkie punkty przerwania polecenia ustawione na poleceniach Read-Host lub Write-Host w pliku Sample.ps1.
Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"
Przykład 6. Pobieranie punktów przerwania poleceń w określonym pliku
Get-PSBreakpoint -Type Command -Script "Sample.ps1"
To polecenie pobiera wszystkie punkty przerwania poleceń w pliku Sample.ps1.
Przykład 7. Pobieranie punktów przerwania według zmiennej
To polecenie pobiera punkty przerwania ustawione na $Index i $Swap zmiennych w bieżącej sesji.
Get-PSBreakpoint -Variable "Index, Swap"
Przykład 8. Pobieranie wszystkich punktów przerwania linii i zmiennych w pliku
To polecenie pobiera wszystkie punkty przerwania wierszy i zmiennych w skry skryptie Sample.ps1.
Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Przykład 9. Pobieranie punktów przerwania ustawionych w określonej 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. Następnie możesz sprawdzić punkt przerwania w zmiennej $breakpoint.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
$breakpoint = Get-PSBreakpoint -Runspace $runspace
Parametry
-Command
Określa tablicę punktów przerwania poleceń, które są ustawione na określonych nazwach poleceń. Wprowadź nazwy poleceń, takie jak nazwa polecenia cmdlet lub funkcji.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Command
| Position: | Named |
| Obowiązkowy: | True |
| 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 pobierane przez to polecenie cmdlet. Wprowadź identyfikatory na liście rozdzielanej przecinkami. Można również przekazać identyfikatory punktów przerwania do Get-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ązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| 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 |
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 |
-Script
Określa tablicę skryptów, które zawierają punkty przerwania. Wprowadź ścieżkę (opcjonalnie) i nazwy co najmniej jednego pliku skryptu. Jeśli pominięto ścieżkę, domyślną lokalizacją jest bieżący katalog.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Script
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
Variable
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
Command
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
Type
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Type
Określa tablicę typów punktów przerwania pobieranych przez to polecenie cmdlet. Wprowadź co najmniej jeden typ. Dopuszczalne wartości tego parametru to:
- Linia
- Komenda
- Zmienna
Można również potokować typy punktów przerwania do Get-PSBreakpoint.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | Line, Variable, Command |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Type
| 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 |
-Variable
Określa tablicę zmiennych punktów przerwania, które są ustawione na określonych nazwach zmiennych. Wprowadź nazwy zmiennych bez znaków dolara.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Variable
| Position: | Named |
| Obowiązkowy: | True |
| 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
Int32
Do tego polecenia cmdlet można potokować identyfikatory punktów przerwania.
BreakpointType
Typy punktów przerwania można potokować do tego polecenia cmdlet.
Dane wyjściowe
CommandBreakpoint
LineBreakpoint
VariableBreakpoint
Breakpoint
To polecenie cmdlet zwraca obiekty reprezentujące punkty przerwania w sesji.
Uwagi
Program PowerShell zawiera następujące aliasy dla Get-PSBreakpoint:
- Wszystkie platformy:
gbp
