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[]>]
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Int32[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:Runspace
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:BreakpointType[]
Dopuszczalne wartości:Line, Variable, Command
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

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