Get-PSBreakpoint
Získá zarážky, které jsou nastaveny v aktuální relaci.
Syntax
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>]
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"
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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ář.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | BreakpointType[] |
Accepted values: | Line, Variable, Command |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
ID zarážky můžete do této rutiny převést.
K této rutině můžete převést typy zarážek.
Výstupy
Tato rutina vrátí objekty, které představují zarážky v relaci.
Poznámky
Windows PowerShell obsahuje následující aliasy pro Get-PSBreakpoint
:
gbp
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro