Sdílet prostřednictvím

Remove-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Odstraní zarážky z aktuální konzoly.

Syntax

Breakpoint (Výchozí) 

Remove-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id 

Remove-PSBreakpoint
    [-Id] <Int32[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Remove-PSBreakpoint odstraní zarážku. Zadejte objekt zarážky nebo ID zarážky.

Když odeberete zarážku, objekt zarážky už není dostupný ani funkční. Pokud jste uložili objekt zarážky do proměnné, odkaz stále existuje, ale zarážka nefunguje.

Remove-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: Odebrání všech zarážek

PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint

Tento příkaz odstraní všechny zarážky v aktuální konzole.

Příklad 2: Odebrání zadané zarážky

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint

Tento příkaz odstraní zarážku.

První příkaz použije rutinu Set-PSBreakpoint k vytvoření zarážky pro proměnnou Name ve skriptu Sample.ps1. Potom uloží objekt zarážky do proměnné $B.

Druhý příkaz používá rutinu Remove-PSBreakpoint k odstranění nové zarážky. Pomocí operátoru kanálu (|) odešle objekt zarážky v proměnné $B do rutiny Remove-PSBreak point.

V důsledku tohoto příkazu, pokud skript spustíte, proběhne až do konce bez zastavení. Rutina Get-PSBreakpoint také nevrací tuto zarážku.

Příklad 3: Odebrání bodu přerušení podle ID

PS C:\> Remove-PSBreakpoint -Id 2

Tento příkaz odstraní zarážku s ID zarážky 2.

Příklad 4: Použití funkce k odebrání všech zarážek

PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }

Tato jednoduchá funkce odstraní všechny zarážky v aktuální konzole. K získání zarážek používá rutinu Get-PSBreakpoint. Potom pomocí operátoru kanálu (|) odešle zarážky do rutiny Remove-PSBreakpoint, která je odstraní.

V důsledku toho můžete místo delšího příkazu zadat del-psb.

Pokud chcete funkci uložit, přidejte ji do profilu Windows PowerShellu.

Parametry

-Breakpoint

Určuje zarážky, které se mají odstranit. 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 lze také Remove-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 ID zarážek, pro které tato rutina odstraní zarážky.

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

-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

Objekty zarážky lze převést na Remove-PSBreakpoint.

Výstupy

None

Rutina negeneruje žádný výstup.