Get-PSBreakpoint
Získá zarážky, které jsou nastaveny v aktuální relaci.
Syntax
Line (Výchozí)
Get-PSBreakpoint
[[-Script] <String[]>]
[-Runspace <Runspace>]
[<CommonParameters>]
Command
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Variable
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Id
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 ve funkci přírůstku ve skriptu Sample.ps1 a uloží objekt zarážky do proměnné $B. Vlastnost ID objektu zarážky v proměnné $B se předá do rutiny 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 Sample.ps1 a SupportScript.ps1 soubory.
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ů nastavené na Read-Host nebo Write-Host příkazy v souboru Sample.ps1.
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é na $Index a $Swap proměnné v aktuální relaci.
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á všechny zarážky řádků a proměnných ve skriptu Sample.ps1.
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 zastavila, když je spuštěn Set-PSBreakPoint. Runspace se uloží do proměnné a předá se k příkazu Get-PSBreakPoint s parametrem Runspace. Pak můžete zkontrolovat zarážku v proměnné $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
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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Command
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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é zarážky zarážky Get-PSBreakpoint.
Vlastnosti parametru
| Typ: | Int32[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Id
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Runspace
Určuje ID objektu Runspace, abyste mohli pracovat se zarážkami v zadaném runspace.
Tento parametr byl přidán v PowerShellu 7.2.
Vlastnosti parametru
| Typ: | Runspace |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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ář.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Script
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Variable
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Command
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Type
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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á
K Get-PSBreakPointlze také převést typy zarážek .
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Přípustné hodnoty: | Line, Variable, Command |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Type
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Variable
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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