Get-PSBreakpoint
Pobiera punkty przerwania ustawione w bieżącej sesji.
Składnia
Get-PSBreakpoint
[-Script <String[]>]
[<CommonParameters>]
Get-PSBreakpoint
[-Script <String[]>]
-Variable <String[]>
[<CommonParameters>]
Get-PSBreakpoint
[-Script <String[]>]
-Command <String[]>
[<CommonParameters>]
Get-PSBreakpoint
[-Script <String[]>]
[-Type] <BreakpointType[]>
[<CommonParameters>]
Get-PSBreakpoint
[-Id] <Int32[]>
[<CommonParameters>]
Opis
Polecenie Get-PSBreakPoint
cmdlet 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 do Get-PSBreakpoint
.
$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint
Polecenie Set-PSBreakpoint
cmdlet tworzy punkt przerwania w funkcji Increment w Sample.ps1
skrycie i zapisuje obiekt punktu przerwania w zmiennej $B
. Właściwość Id obiektu punktu przerwania w $B
zmiennej jest potokowana do Get-PSBreakpoint
polecenia cmdlet 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 Sample.ps1
plikach 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 poleceń ustawione w Read-Host
pliku lub Write-Host
polecenia 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 polecenia w pliku Sample.ps1.
Przykład 7. Pobieranie punktów przerwania według zmiennej
To polecenie pobiera punkty przerwania ustawione na $Index
zmienne i $Swap
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 Sample.ps1
skry skrycie.
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Określa identyfikatory punktów przerwania pobierane przez to polecenie cmdlet. Wprowadź identyfikatory na liście rozdzielanej przecinkami. Można również potokować identyfikatory punktów przerwania do Get-PSBreakpoint
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
- Polecenie
- Zmienna
Można również potokować typy punktów przerwania do Get-PSBreakPoint
.
Type: | BreakpointType[] |
Accepted values: | Line, Variable, Command |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
Do tego polecenia cmdlet można potokować identyfikatory punktów przerwania.
Typy punktów przerwania można potokować do tego polecenia cmdlet.
Dane wyjściowe
To polecenie cmdlet zwraca obiekty reprezentujące punkty przerwania w sesji.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla programu Get-PSBreakpoint
:
gbp
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla