Sdílet prostřednictvím

Enable-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntaxe

Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-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 zarážky můžete také Enable-PSBreakpoint.

Typ:Breakpoint[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

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

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 Enable-PSBreakpointnemůžete ID čísla . Pokud chcete najít ID zarážky, použijte rutinu Get-PSBreakpoint.

Typ:Int32[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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.