Disable-PSBreakpoint

Syntaxe

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

Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-Runspace <Runspace>]
       [-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 . Zarážky se ve výchozím nastavení povolí 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 pro $Name proměnnou ve Sample.ps1 skriptu a uloží objekt zarážky do $B proměnné. Rutina Disable-PSBreakpoint zakáže novou zarážku. Používá operátor kanálu (|) k odeslání objektu $B zarážky do rutiny Disable-PSBreakpoint .

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

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)

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

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

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

Příklad 5: Zakázání zarážky v prostředí runspace

V tomto příkladu se spustí úloha a zarážka se nastaví tak, aby se přerušil při Set-PSBreakPoint spuštění. 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 Disable-PSBreakpoint zakázání zarážky v prostředí runspace.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

Parametry

-Breakpoint

-Confirm

-Id

-PassThru

-Runspace

-WhatIf

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í zakázanou zarážku.

Poznámky

PowerShell obsahuje následující aliasy pro Disable-PSBreakpoint:

• Všechny platformy:
  • dbp

Související odkazy

• Enable-PSBreakpoint
• Get-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint