Sdílet prostřednictvím

Enable-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Id (Výchozí) 

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

Breakpoint 

Enable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-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.

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

-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 pipetovat do Enable-PSBreakpoint.

Výstupy

None or System.Management.Automation.Breakpoint

Když použijete parametr PassThru, Enable-PSBreakpoint vrátí objekt zarážky, který představuje povolenou zarážku. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • 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.