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ž zaručuje, ž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. Ve výchozím nastavení jsou zarážky 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ů PowerShellu. Další informace o ladicím programu PowerShellu najdete v tématu about_Debuggers.
Příklady
Příklad 1: Nastavení zarážky a zakázání
Tyto příkazy zakazují nově vytvořenou zarážku.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
Rutina Set-PSBreakpoint vytvoří zarážku na proměnné $Name ve skriptu Sample.ps1 a uloží objekt zarážky do proměnné $B. Rutina Disable-PSBreakpoint zakáže novou zarážku. K odeslání objektu zarážky v | do rutiny $B používá operátor kanálu (Disable-PSBreakpoint).
V důsledku tohoto příkazu je hodnota vlastnosti Enabled objektu zarážky v $BFalse.
Příklad 2: Zakázání zarážky
Tento příkaz zakáže zarážku s ID zarážky 0.
Disable-PSBreakpoint -Id 0
Příklad 3: Vytvoření zakázané zarážky
Tento příkaz vytvoří novou zarážku, která je zakázaná, dokud ho neaktivujete.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
K zakázání zarážky používá rutinu Disable-PSBreakpoint. Hodnota parametru Breakpoint je Set-PSBreakpoint příkaz, který nastaví novou zarážku, vygeneruje objekt zarážky a uloží ho 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 vygeneruje objekt zarážky, lze jej použít jako hodnotu Breakpoint parametru.
Příklad 4: Zakázání všech zarážek v aktuální konzole
Tento příkaz zakáže všechny zarážky v aktuální konzole.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Parametry
-Breakpoint
Určuje zarážky, které se mají zakázat. Zadejte proměnnou obsahující objekty zarážek nebo příkaz, který vrací objekty zarážek, například příkaz Get-PSBreakpoint. Objekty zarážky můžete také pipetovat do rutiny Disable-PSBreakpoint.
Vlastnosti parametru
| Typ: | |
| 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
Zakáže zarážky se zadanými ID zarážky. Zadejte ID nebo proměnnou, která obsahuje ID. ID nelze převést na 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í povolené zarážky. 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 pipetovat do Disable-PSBreakpoint.
Výstupy
None or System.Management.Automation.Breakpoint
Při použití parametru PassThru vrátí objekt, Disable-PSBreakpoint který představuje zakázanou zarážku. Jinak tento příkaz negeneruje žádný výstup.