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[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <Int32[]>
   [<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ů Windows PowerShellu. Další informace o ladicím programu Prostředí Windows PowerShell najdete v tématu about_Debuggers.

Příklady

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

PS C:\> Get-PSBreakpoint

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

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

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

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

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

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint

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

První příkaz používá rutinu Set-PSBreakpoint k vytvoření zarážky ve funkci Increment ve skriptu Sample.ps1. Uloží objekt zarážky do proměnné $B.

Druhý příkaz pomocí operátoru tečky (.) získá vlastnost ID objektu zarážky v proměnné $B. Pomocí operátoru kanálu (|) odešle ID rutině Get-PSBreakpoint.

V důsledku toho Get-PSBreakpoint získá zarážku se zadaným ID.

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

PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

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

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

PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

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

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

PS C:\> 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é

PS C:\> Get-PSBreakpoint -Variable "Index, Swap"

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

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

PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

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

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

-Script

Určuje pole skriptů, které obsahují zarážky. Zadejte cestu 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:0
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ů. Přijatelné hodnoty pro tento parametr jsou:

  • Řádek
  • Příkaz
  • Proměnná

Typy zarážek můžete 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

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

ID zarážky a typy zarážek můžete převést na Get-PSBreakPoint.

Výstupy

Breakpoint

Get-PSBreakPoint vrátí objekty, které představují zarážky v relaci.

Poznámky

  • Můžete použít Get-PSBreakpoint nebo jeho alias gbp.