Enable-PSBreakpoint

Modul:

Microsoft.PowerShell.Utility Module

Povolí zarážky v aktuální konzole.

Syntax

Breakpoint (Výchozí)

Enable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id

Enable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-Runspace <Runspace>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Enable-PSBreakpoint znovu povolí zakázané zarážky. Můžete ho použít k povolení všech zarážek nebo konkrétních zarážek tím, že poskytnete objekty nebo ID zarážky.

Zarážka je bod ve skriptu, kde se provádění dočasně zastaví, abyste mohli prozkoumat stav skriptu. Nově vytvořené zarážky jsou automaticky povoleny, ale je možné je zakázat pomocí Disable-PSBreakpoint.

Technicky vzato tato rutina změní hodnotu vlastnosti Enabled objektu zarážky na True.

Enable-PSBreakpoint je jednou z několika rutin navržených pro ladění skriptů PowerShellu. Další informace o ladicím programu PowerShellu najdete v tématu about_Debuggers.

Příklady

Příklad 1: Povolení všech zarážek

Tento příklad povolí všechny zarážky v aktuální relaci.

Get-PSBreakpoint | Enable-PSBreakpoint

Pomocí aliasů lze tento příklad zkrátit jako gbp | ebp.

Příklad 2: Povolení zarážek podle ID

Tento příklad umožňuje více zarážek pomocí jejich ID zarážky.

Enable-PSBreakpoint -Id 0, 1, 5

Příklad 3: Povolení zakázané zarážky

Tento příklad znovu povolí zarážku, která byla zakázána.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint vytvoří zarážku na proměnné Name ve skriptu Sample.ps1, který uloží objekt zarážky do proměnné $B. Parametr PassThru zobrazí hodnotu vlastnosti Enabled zarážky je False.

Enable-PSBreakpoint zarážku znovu povolí. Opět pomocí parametru PassThru vidíme, že hodnota vlastnosti Enabled je True.

Příklad 4: Povolení zarážek pomocí proměnné

Tento příklad umožňuje sadu zarážek pomocí objektů zarážky.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint získá zarážky a uloží je do proměnné $B. Pomocí parametru zarážky zarážky povolíte.

Tento příklad je ekvivalentní spuštění Enable-PSBreakpoint -Id 3, 5.

Příklad 5: Povolení zarážky v prostředí runspace

V tomto příkladu je úloha spuštěná se zarážkou nastavená tak, aby byla zakázaná. Runspace se uloží do proměnné a předá se k příkazu Get-PSBreakPoint s parametrem Runspace. Výstup Get-PSBreakPoint se předá do Enable-PSBreakpoint a povolí zarážku v prostředí runspace.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Parametry

-Breakpoint

Určuje zarážky, které se mají povolit. Zadejte proměnnou obsahující zarážky nebo příkaz, který získá objekty zarážky, například Get-PSBreakpoint. Objekty přerušeovací můžete také přeposílat do Enable-PSBreakpoint.

Vlastnosti parametru

Typ:	Breakpoint[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Breakpoint

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

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

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

-Id

Určuje id čísel zarážek, které se mají povolit. Výchozí hodnota je všechny zarážky. Zadejte ID číslem nebo proměnnou. Do nemůžete Enable-PSBreakpoint čísla . Pokud chcete najít ID zarážky, použijte rutinu 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:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PassThru

Vrátí objekt představující povolenou zarážku. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Vlastnosti parametru

Typ:	SwitchParameter
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

-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
Aliasy:	RunspaceId

Sady parametrů

Id

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

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

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

Breakpoint

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

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

Breakpoint

Pokud použijete parametr PassThru, vrátí tato rutina objekt zarážky představující povolenou zarážku.

Poznámky

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

• Všechny platformy:

  • ebp

• Rutina Enable-PSBreakpoint negeneruje chybu, pokud se pokusíte povolit zarážku, která je už povolená. Proto můžete povolit všechny zarážky bez chyby, i když je zakázané jenom několik.

• Zarážky se povolí při jejich vytváření pomocí rutiny Set-PSBreakpoint. Nově vytvořené zarážky nemusíte povolovat.

Související odkazy

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