Delen via

Remove-PSBreakpoint

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u onderbrekingspunten uit de huidige console.

Syntaxis

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

Description

De cmdlet Remove-PSBreakpoint verwijdert een onderbrekingspunt. 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 Windows PowerShell-scripts. Zie about_Debuggers voor meer informatie over het Windows PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Alle onderbrekingspunten verwijderen

PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint

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

Voorbeeld 2: Een opgegeven onderbrekingspunt verwijderen

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint

Met deze opdracht wordt een onderbrekingspunt verwijderd.

De eerste opdracht maakt gebruik van de cmdlet Set-PSBreakpoint om een onderbrekingspunt te maken voor de variabele Naam in het Sample.ps1 script. Vervolgens wordt het onderbrekingspuntobject opgeslagen in de variabele $B.

De tweede opdracht gebruikt de cmdlet Remove-PSBreakpoint om het nieuwe onderbrekingspunt te verwijderen. Er wordt een pijplijnoperator (|) gebruikt om het onderbrekingspuntobject in de $B variabele te verzenden naar de cmdlet Remove-PSBreakpoint.

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

PS C:\> Remove-PSBreakpoint -Id 2

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

Voorbeeld 4: Een functie gebruiken om alle onderbrekingspunten te verwijderen

PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }

Met deze eenvoudige functie worden alle onderbrekingspunten in de huidige console verwijderd. De cmdlet Get-PSBreakpoint wordt gebruikt om de onderbrekingspunten op te halen. Vervolgens wordt een pijplijnoperator (|) gebruikt om de onderbrekingspunten te verzenden naar de cmdlet Remove-PSBreakpoint, waardoor ze worden verwijderd.

Als gevolg hiervan kunt u del-psb typen in plaats van de langere opdracht.

Als u de functie wilt opslaan, voegt u deze toe aan uw Windows PowerShell-profiel.

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 opdracht Get-PSBreakpoint. U kunt ook onderbrekingspuntobjecten naar Remove-PSBreakpoint.

Type:Breakpoint[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Breakpoint

U kunt onderbrekingspuntobjecten naar Remove-PSBreakpoint.

Uitvoerwaarden

None

De cmdlet genereert geen uitvoer.