Get-PSBreakpoint

Modul:

Microsoft.PowerShell.Utility Module

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

Syntaxe

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:	BreakpointType[]
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

Související odkazy

• Disable-PSBreakpoint
• Enable-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint