Disable-PSBreakpoint
Zakáže zarážky v aktuální konzole.
Syntax
Breakpoint (Výchozí)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-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.
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 pole ID nebo proměnných, které obsahují ID zarážek. ID nelze Disable-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í položku, se kterou pracujete. 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í. Příkazový modul nebyl spuštěn.
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 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 tento příkaz negeneruje žádný výstup.