Sdílet prostřednictvím

Remove-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntaxe

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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.

Pokud skript spustíte, spustí se v důsledku tohoto příkazu dokončení bez zastavení. Rutina Get-PSBreakpoint také nevrací tuto zarážku.

Příklad 3: Odebrání zarážky 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.

Typ:Breakpoint[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID zarážek, pro které tato rutina odstraní zarážky.

Typ:Int32[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

Breakpoint

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

Výstupy

None

Rutina negeneruje žádný výstup.