Sdílet prostřednictvím

Get-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá zarážky, které jsou nastaveny v aktuální relaci.

Syntaxe

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>]

Description

Rutina Get-PSBreakPoint získá zarážky nastavené v aktuální relaci. Pomocí parametrů rutiny můžete získat konkrétní zarážky.

Zarážka je bod v příkazu nebo skriptu, kde se provádění dočasně zastaví, abyste mohli prozkoumat pokyny. Get-PSBreakpoint je jednou z několika rutin navržených pro ladění skriptů a příkazů PowerShellu. Další informace o ladicím programu PowerShellu najdete v tématu about_Debuggers.

Příklady

Příklad 1: Získání všech zarážek pro všechny skripty a funkce

Tento příkaz získá všechny zarážky nastavené pro všechny skripty a funkce v aktuální relaci.

Get-PSBreakpoint

Příklad 2: Získání zarážek podle ID

Tento příkaz získá zarážku s ID zarážky 2.

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Příklad 3: Připojení ID k get-PSBreakpoint

Tyto příkazy ukazují, jak získat zarážku propojením ID zarážky do Get-PSBreakpoint.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Rutina Set-PSBreakpoint vytvoří zarážku pro funkci Increment ve Sample.ps1 skriptu a uloží objekt zarážky do $B proměnné. Vlastnost ID objektu zarážky v $B proměnné je předaná rutině Get-PSBreakpoint , aby se zobrazily informace o zarážce.

Příklad 4: Získání zarážek v zadaných souborech skriptu

Tento příkaz získá všechny zarážky v souborech Sample.ps1 a SupportScript.ps1 souborech.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Tento příkaz nezískáte další zarážky, které mohou být nastaveny v jiných skriptech nebo ve funkcích v relaci.

Příklad 5: Získání zarážek v zadaných rutinách

Tento příkaz získá všechny zarážky příkazů, které jsou nastavené na Read-Host soubor nebo Write-Host příkazy v Sample.ps1 souboru.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Příklad 6: Získání zarážek příkazů v zadaném souboru

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Tento příkaz získá všechny zarážky příkazů v souboru Sample.ps1.

Příklad 7: Získání zarážek podle proměnné

Tento příkaz získá zarážky nastavené v $Index aktuální relaci a $Swap proměnné.

Get-PSBreakpoint -Variable "Index, Swap"

Příklad 8: Získání všech zarážek řádků a proměnných v souboru

Tento příkaz získá ve Sample.ps1 skriptu všechny zarážky řádků a proměnných.

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

Příklad 9: Získání zarážek nastavených v konkrétním prostředí runspace

V tomto příkladu se spustí úloha a zarážka se nastaví tak, aby se přerušil při Set-PSBreakPoint spuštění. Runspace je uložen v proměnné a předán do Get-PSBreakPoint příkazu s parametrem Runspace . Pak můžete zkontrolovat zarážku v $breakpoint proměnné.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Parametry

-Command

Určuje pole zarážek příkazů, které jsou nastavené na zadaných názvech příkazů. Zadejte názvy příkazů, například název rutiny nebo funkce.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID zarážek, které tato rutina získá. Zadejte ID v seznamu odděleném čárkami. Id zarážky můžete také převést na Get-PSBreakpoint.

Typ:Int32[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Runspace

Určuje ID objektu Runspace , abyste mohli pracovat se zarážky v zadaném prostředí runspace.

Tento parametr byl přidán v PowerShellu 7.2.

Typ:Runspace
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Script

Určuje pole skriptů, které obsahují zarážky. Zadejte cestu (volitelné) a názvy jednoho nebo více souborů skriptu. Pokud tuto cestu vynecháte, výchozí umístění je aktuální adresář.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Type

Určuje pole typů zarážek, které tato rutina získá. Zadejte jeden nebo více typů. Tento parametr přijímá tyto hodnoty:

  • Line
  • Příkaz
  • Proměnná

Typ zarážky lze také převést na Get-PSBreakPoint.

Typ:BreakpointType[]
Přípustné hodnoty:Line, Variable, Command
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Variable

Určuje pole zarážek proměnných, které jsou nastaveny na zadaných názvech proměnných. Zadejte názvy proměnných bez znaků dolaru.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

Int32

ID zarážky můžete do této rutiny převést.

BreakpointType

K této rutině můžete převést typy zarážek.

Výstupy

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Tato rutina vrátí objekty, které představují zarážky v relaci.

Poznámky

PowerShell obsahuje následující aliasy pro Get-PSBreakpoint:

  • Všechny platformy:
    • gbp