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[]>
    [-Runspace <Runspace>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdlet 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 na proměnné $Name ve skriptu Sample.ps1 a uloží objekt zarážky do proměnné $B. Cmdlet Remove-PSBreakpoint odstraní nový breakpoint. Operátor roury (|) se používá k odeslání objektu zarážky uloženého v proměnné $B do rutiny Remove-PSBreakpoint.

V důsledku tohoto příkazu, pokud skript spustíte, proběhne až do konce bez zastavení. Cmdlet Get-PSBreakpoint také nevrátí tento bod přerušení.

Příklad 3: Odebrání bodu přerušení 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 }

K získání zarážek používá cmdlet Get-PSBreakpoint. Potom pomocí operátoru kanálu (|) odešle zarážky do rutiny 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 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 Remove-PSBreakpoint, aby se odstranil breakpoint v 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ý vrací objekty zarážek, například příkaz Get-PSBreakpoint. Objekty přerušeovací můžete také přeposílat do 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

-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

Objekty zarážky můžete do této rutiny převést.

Int32

Runspace

Výstupy

None

Tento cmdlet nevrátí žádný výstup.

Poznámky

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

  • Všechny platformy:
    • rbp