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

De Remove-PSBreakpoint cmdlet 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 PowerShell-scripts. Zie about_Debuggers voor meer informatie over het Foutopsporingsprogramma van PowerShell.

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 voor 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 het als gevolg van deze opdracht uitgevoerd tot voltooiing zonder te stoppen. Get-PSBreakpoint De cmdlet 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 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.

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 taak wordt uitgevoerd. De runspace wordt opgeslagen in een variabele en doorgegeven aan de Get-PSBreakPoint opdracht met de parameter Runspace . De uitvoer wordt Get-PSBreakPoint doorgesluisd om het onderbrekingspunt in de runspace te Remove-PSBreakpoint 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 bevat of een opdracht waarmee onderbrekingspuntobjecten worden opgehaald, zoals een Get-PSBreakpoint opdracht. U kunt ook onderbrekingspuntobjecten Remove-PSBreakpointnaar .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
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
Required: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
Required:True
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.

Deze parameter is toegevoegd in PowerShell 7.2.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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