Remove-PSBreakpoint

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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.

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

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
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[]

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