Sdílet prostřednictvím

Disable-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

Zakáže zarážky v aktuální konzole.

Syntaxe

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

Description

Rutina Disable-PSBreakpoint zakáže zarážky, což zajistí, že se při spuštění skriptu nenarazí. Můžete ho použít k zakázání všech zarážek nebo můžete zadat zarážky odesláním objektů zarážek nebo ID zarážek.

Technicky vzato tato rutina změní hodnotu vlastnosti Enabled objektu zarážky na False. K opětovnému povolení zarážky použijte rutinu Enable-PSBreakpoint. Zarážky jsou ve výchozím nastavení povolené při jejich vytváření pomocí rutiny Set-PSBreakpoint.

Zarážka je bod ve skriptu, kde se provádění dočasně zastaví, abyste mohli prozkoumat pokyny ve skriptu. Disable-PSBreakpoint je jednou z několika rutin navržených pro ladění skriptů Windows PowerShellu. Další informace o ladicím programu Prostředí Windows PowerShell najdete v tématu about_Debuggers.

Příklady

Příklad 1: Nastavení zarážky a zakázání

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Tyto příkazy zakazují nově vytvořenou zarážku.

První příkaz pomocí rutiny Set-PSBreakpoint vytvoří zarážku na proměnné Name ve skriptu Sample.ps1. Potom uloží objekt zarážky do proměnné $B.

Druhý příkaz používá rutinu Disable-PSBreakpoint k zakázání nové zarážky. Pomocí operátoru kanálu (|) odešle objekt zarážky v $B do rutiny Disable-PSBreak point.

V důsledku tohoto příkazu je hodnota Enabled vlastnost zarážky objektu v $B False.

Příklad 2: Zakázání zarážky

PS C:\> Disable-PSBreakpoint -Id 0

Tento příkaz zakáže zarážku s ID zarážky 0.

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

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Tento příkaz vytvoří novou zarážku, která je zakázaná, dokud ho neaktivujete.

K zakázání zarážky používá rutinu Disable-PSBreakpoint. Hodnota parametru Breakpoint je příkaz Set-PSBreakpoint, který nastaví novou zarážku, vygeneruje objekt zarážky a uloží objekt do proměnné $B.

Parametry rutiny, které přijímají objekty jako jejich hodnoty, můžou přijmout proměnnou obsahující objekt nebo příkaz, který objekt získá nebo vygeneruje. V tomto případě, protože Set-PSBreakpoint generuje objekt zarážky, lze jej použít jako hodnotu Breakpoint parametru.

Druhý příkaz zobrazí objekt zarážky v hodnotě proměnné $B.

Příklad 4: Zakázání všech zarážek v aktuální konzole

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Tento příkaz zakáže všechny zarážky v aktuální konzole. Tento příkaz můžete zkrátit takto: "gbp | dbp".

Parametry

-Breakpoint

Určuje zarážky, které se mají zakázat. Zadejte proměnnou obsahující objekty zarážek nebo příkaz, který získá objekty zarážky, například příkaz Get-PSBreakpoint. Objekty zarážky můžete také převést do rutiny Disable-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 pole ID nebo proměnných, které obsahují ID zarážek. ID nelze Disable-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í položku, se kterou pracujete. 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 převést na Disable-PSBreakpoint.

Výstupy

None or System.Management.Automation.Breakpoint

Pokud použijete parametr PassThru, Disable-PSBreakpoint vrátí objekt, který představuje zarážku zakázáno. Jinak tato rutina negeneruje žádný výstup.