Remove-PSBreakpoint

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee verwijdert u onderbrekingspunten uit de huidige console.

Syntax

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

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

Description

Met de Remove-PSBreakpoint cmdlet 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_Debuggers voor 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 Set-PSBreakpoint cmdlet maakt een onderbrekingspunt op de $Name variabele in het Sample.ps1 script en slaat het onderbrekingspuntobject op in de $B variabele. De Remove-PSBreakpoint cmdlet verwijdert het nieuwe onderbrekingspunt. 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 deze als gevolg van deze opdracht uitgevoerd zonder te stoppen. Get-PSBreakpoint De cmdlet retourneert ook dit onderbrekingspunt niet.

Voorbeeld 3: Een onderbrekingspunt verwijderen op id

Met deze opdracht verwijdert u het onderbrekingspunt met onderbrekingspunt-id 2.

Remove-PSBreakpoint -Id 2

Voorbeeld 4: Een functie gebruiken om alle onderbrekingspunten te verwijderen

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

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

De cmdlet wordt gebruikt Get-PSBreakpoint 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.

Parameters

-Breakpoint

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

Type:	Breakpoint[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	Int32[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Runspace

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

Type:	Runspace
Aliases:	RunspaceId
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

Breakpoint[]

U kunt onderbrekingspuntobjecten doorsluisen naar Remove-PSBreakpoint.

Int32[]

Runspace

Uitvoerwaarden

None

De cmdlet genereert geen uitvoer.