Sdílet prostřednictvím

Enable-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntaxe

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-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 Hodnotu 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 na 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 pro proměnnou Name ve Sample.ps1 skriptu, který ukládá objekt zarážky v $B proměnné. Parametr PassThru zobrazí hodnotu Vlastnosti Enabled zarážky False.

Enable-PSBreakpoint Znovu povolí zarážku. Opět pomocí parametru PassThru vidíme, že hodnota Enabled vlastnost 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 $B proměnné. Pomocí parametru Enable-PSBreakpoint Zarážka povolíte zarážky.

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 je uložen v proměnné a předán do Get-PSBreakPoint příkazu s parametrem Runspace . Výstupem Get-PSBreakPoint kanálu je Enable-PSBreakpoint povolení zarážky 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 zarážky lze také převést na 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 zobrazí výzvu 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 čísla ID zarážek, která se mají povolit. Výchozí hodnota je všechny zarážky. Zadejte ID podle čísla nebo proměnné. Čísla ID kanálu nemůžete převést na Enable-PSBreakpoint. K vyhledání 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

-Runspace

Určuje ID objektu Runspace , abyste mohli pracovat se zarážky v zadaném prostředí runspace.

Tento parametr byl přidán v PowerShellu 7.2.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. 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 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

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

  • Zarážky se povolí, když je vytvoříte pomocí rutiny Set-PSBreakpoint . Nově vytvořené zarážky nemusíte povolovat.