Disable-PSBreakpoint

Modul:

Microsoft.PowerShell.Utility Module

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]
    [-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. 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

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 zastavila, když je spuštěn Set-PSBreakPoint. Runspace se uloží do proměnné a předá se k příkazu Get-PSBreakPoint s parametrem Runspace. Výstup Get-PSBreakPoint se předá do Disable-PSBreakpoint a zakáže zarážku 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ý vrací objekty zarážek, například příkaz Get-PSBreakpoint. Objekty zarážky můžete také pipetovat 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

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

-Runspace

Určuje ID objektu Runspace, abyste mohli pracovat se zarážkami v zadaném runspace.

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

Vlastnosti parametru

Typ:	Runspace
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	RunspaceId

Sady parametrů

Id

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
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 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