Delen via

Remove-PSBreakpoint

Module:
Microsoft.PowerShell.Utility Module

Hiermee verwijdert u onderbrekingspunten uit de huidige console.

Syntaxis

Breakpoint (Standaard) 

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

Id 

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

Description

Met de cmdlet Remove-PSBreakpoint wordt een onderbrekingspunt verwijderd. Voer een onderbrekingspuntobject of een onderbrekingspunt-id in.

Wanneer u een onderbrekingspunt verwijdert, is het onderbrekingspuntobject niet meer beschikbaar of functioneel. Als u een onderbrekingspuntobject in een variabele hebt opgeslagen, bestaat de verwijzing nog steeds, maar werkt het onderbrekingspunt niet.

Remove-PSBreakpoint is een van de verschillende cmdlets die zijn ontworpen voor het opsporen van fouten in PowerShell-scripts. Zie about_Debuggersvoor meer informatie over het PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Alle onderbrekingspunten verwijderen

Met deze opdracht worden alle onderbrekingspunten in de huidige console verwijderd.

Get-PSBreakpoint | Remove-PSBreakpoint

Voorbeeld 2: Een opgegeven onderbrekingspunt verwijderen

Met deze opdracht wordt een onderbrekingspunt verwijderd.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint

De cmdlet Set-PSBreakpoint maakt een onderbrekingspunt op de $Name variabele in het Sample.ps1 script en slaat het onderbrekingspuntobject op in de $B variabele. Met de cmdlet Remove-PSBreakpoint wordt het nieuwe onderbrekingspunt verwijderd. Er wordt een pijplijnoperator (|) gebruikt om het onderbrekingspuntobject in de $B variabele naar de Remove-PSBreakpoint-cmdlet te verzenden.

Als u het script uitvoert, wordt het als gevolg van deze opdracht uitgevoerd tot voltooiing zonder te stoppen. De cmdlet Get-PSBreakpoint retourneert dit onderbrekingspunt ook niet.

Voorbeeld 3: Een onderbrekingspunt verwijderen op id

Met deze opdracht wordt het onderbrekingspunt met onderbrekingspunt-id 2 verwijderd.

Remove-PSBreakpoint -Id 2

Voorbeeld 4: Een functie gebruiken om alle onderbrekingspunten te verwijderen

Met deze eenvoudige functie worden alle onderbrekingspunten in de huidige sessie verwijderd.

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

De cmdlet Get-PSBreakpoint wordt gebruikt om de onderbrekingspunten op te halen. Vervolgens wordt een pijplijnoperator (|) gebruikt om de onderbrekingspunten naar de Remove-PSBreakpoint cmdlet te verzenden, waardoor ze worden verwijderd.

Voorbeeld 5: Een onderbrekingspunt verwijderen in een runspace

In dit voorbeeld wordt een taak gestart en wordt een onderbrekingspunt ingesteld op einde wanneer de Set-PSBreakpoint wordt uitgevoerd. De runspace wordt opgeslagen in een variabele en doorgegeven aan de opdracht Get-PSBreakpoint met de parameter Runspace. De uitvoer van Get-PSBreakpoint wordt doorgesluisd naar Remove-PSBreakpoint om het onderbrekingspunt in de runspace te verwijderen.

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

Parameters

-Breakpoint

Hiermee geeft u de onderbrekingspunten die moeten worden verwijderd. Voer een variabele in die onderbrekingspuntobjecten of een opdracht bevat waarmee onderbrekingspuntobjecten worden opgehaald, zoals een Get-PSBreakpoint opdracht. U kunt ook onderbrekingspuntobjecten naar Remove-PSBreakpoint.

Parametereigenschappen

Type:

Breakpoint[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Breakpoint
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

Hiermee geeft u onderbrekingspunt-id's op waarvoor deze cmdlet onderbrekingspunten verwijdert.

Parametereigenschappen

Type:

Int32[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Id
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Runspace

Hiermee geeft u de id van een Runspace-object op, zodat u kunt communiceren met onderbrekingspunten in de opgegeven runspace.

Deze parameter is toegevoegd in PowerShell 7.2.

Parametereigenschappen

Type:Runspace
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:RunspaceId

Parametersets

Id
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

Breakpoint

U kunt onderbrekingspuntobjecten naar deze cmdlet doorsluisen.

Int32

Runspace

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

PowerShell bevat de volgende aliassen voor Remove-PSBreakpoint:

  • Alle platforms:
    • rbp