Sdílet prostřednictvím

Disable-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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 $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)

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

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 Get-PSBreakpoint příkaz. Objekty zarážky můžete také převést do rutiny Disable-PSBreakpoint .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Vrátí objekt představující povolené zarážky. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Runspace

Určuje ID objektu Runspace , abyste mohli pracovat se zarážky v zadaném prostředí runspace.

Tento parametr byl přidán v PowerShellu 7.2.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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í zakázanou zarážku.

Poznámky

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

  • Všechny platformy:
    • dbp