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 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ážkyEnable-PSBreakpoint 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á Get-PSBreakpoint příkazu 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 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 nemůžete Enable-PSBreakpoint čí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

-Runspace

Určuje ID objektu Runspace, abyste mohli pracovat se zarážkou 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

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