Get-PSBreakpoint
Pobiera punkty przerwania ustawione w bieżącej sesji.
Składnia
Line (domyślnie)
Get-PSBreakpoint
[[-Script] <string[]>]
[<CommonParameters>]
Command
Get-PSBreakpoint
-Command <string[]>
[-Script <string[]>]
[<CommonParameters>]
Variable
Get-PSBreakpoint
-Variable <string[]>
[-Script <string[]>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[-Type] <BreakpointType[]>
[-Script <string[]>]
[<CommonParameters>]
Id
Get-PSBreakpoint
[-Id] <int[]>
[<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"
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ązkowe: | 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ązkowe: | True |
| Wartość z potoku: | True |
| 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ązkowe: | 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ązkowe: | 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ązkowe: | 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ązkowe: | 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ązkowe: | 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ązkowe: | 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
BreakpointType
Identyfikatory punktów przerwania i typy punktów przerwania można przesyłać potokami do Get-PSBreakPoint.
Dane wyjściowe
CommandBreakpoint
LineBreakpoint
VariableBreakpoint
Breakpoint
Get-PSBreakPoint Zwraca obiekty, które reprezentują punkty przerwania w sesji.
Uwagi
Możesz użyć Get-PSBreakpoint lub jego aliasu "gbp".