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[]>
      [-Runspace <Runspace>]
      [-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ů PowerShellu. Další informace o ladicím programu PowerShellu najdete v tématu about_Debuggers.

Příklady

Příklad 1: Odebrání všech zarážek

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

Get-PSBreakpoint | Remove-PSBreakpoint

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

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

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-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 Remove-PSBreakpoint odstraní novou zarážku. K odeslání objektu zarážky v $B proměnné do Remove-PSBreakpoint rutiny používá operátor kanálu (|).

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

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

Remove-PSBreakpoint -Id 2

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

Tato jednoduchá funkce odstraní všechny zarážky v aktuální relaci.

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

Pomocí rutiny Get-PSBreakpoint získá zarážky. Potom pomocí operátoru kanálu (|) odešle zarážky rutině Remove-PSBreakpoint , která je odstraní.

Příklad 5: Odebrá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 Remove-PSBreakpoint odebrá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 | Remove-Breakpoint -Runspace $runspace

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 Get-PSBreakpoint příkaz. Objekty zarážky lze také převést na 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 zobrazí výzvu 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

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

Typ:Runspace
Aliasy:RunspaceId
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

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

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 můžete do této rutiny převést.

Int32[]

Runspace

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

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

  • Všechny platformy:
    • rbp