Udostępnij za pośrednictwem

Get-PSBreakpoint

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Pobiera punkty przerwania ustawione w bieżącej sesji.

Składnia

Get-PSBreakpoint
   [[-Script] <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   -Command <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   -Variable <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Type] <BreakpointType[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <int[]>
   [<CommonParameters>]

Opis

Polecenie Get-PSBreakPoint cmdlet pobiera punkty przerwania ustawione w bieżącej sesji. Parametry polecenia cmdlet umożliwiają uzyskanie określonych punktów przerwania.

Punkt przerwania to punkt w poleceniu lub skrytecie, w którym wykonywanie zatrzymuje się tymczasowo, 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 o identyfikatorze 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 zmiennej $B 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 poleceń 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 wiersza i zmiennej Sample.ps1 w skrycie.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Parametry

-Command

Określa tablicę punktów przerwania poleceń ustawionych 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, które pobiera 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 zawierających 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 dla 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

Int32

BreakpointType

Identyfikatory punktów przerwania i typy punktów przerwania można potokować do Get-PSBreakPoint.

Dane wyjściowe

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Get-PSBreakPoint zwraca obiekty reprezentujące punkty przerwania w sesji.

Uwagi

Możesz użyć Get-PSBreakpoint lub jego aliasu, "gbp".