Feedback

Enable-PSBreakpoint

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schakelt u de onderbrekingspunten in de huidige console in.

Syntax

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Enable-PSBreakpoint cmdlet schakelt uitgeschakelde onderbrekingspunten opnieuw in. U kunt deze gebruiken om alle onderbrekingspunten of specifieke onderbrekingspunten in te schakelen door onderbrekingspuntobjecten of id's op te geven.

Een onderbrekingspunt is een punt in een script waarbij de uitvoering tijdelijk stopt, zodat u de status van het script kunt onderzoeken. Nieuw gemaakte onderbrekingspunten worden automatisch ingeschakeld, maar kunnen worden uitgeschakeld met behulp van Disable-PSBreakpoint.

Technisch gezien wijzigt deze cmdlet de waarde van de eigenschap Ingeschakeld van een onderbrekingspuntobject in Waar.

Enable-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 inschakelen

In dit voorbeeld worden alle onderbrekingspunten in de huidige sessie ingeschakeld.

Get-PSBreakpoint | Enable-PSBreakpoint

Met aliassen kan dit voorbeeld worden afgekort als gbp | ebp.

Voorbeeld 2: Onderbrekingspunten inschakelen op id

In dit voorbeeld worden meerdere onderbrekingspunten ingeschakeld met behulp van hun onderbrekingspunt-id's.

Enable-PSBreakpoint -Id 0, 1, 5

Voorbeeld 3: Een uitgeschakeld onderbrekingspunt inschakelen

In dit voorbeeld wordt een onderbrekingspunt dat is uitgeschakeld, opnieuw ingeschakeld.

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

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint maakt een onderbrekingspunt op de variabele Naam in het Sample.ps1 script waarin het onderbrekingspuntobject in de $B variabele wordt opgeslagen. De parameter PassThru geeft de waarde weer van de eigenschap Ingeschakeld van het onderbrekingspunt is Onwaar.

Enable-PSBreakpoint schakelt het onderbrekingspunt opnieuw in. Nogmaals, met behulp van de PassThru-parameter zien we dat de waarde van de eigenschap Ingeschakeldwaar is.

Voorbeeld 4: Onderbrekingspunten inschakelen met behulp van een variabele

In dit voorbeeld wordt een set onderbrekingspunten ingeschakeld met behulp van de onderbrekingspuntobjecten.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint haalt de onderbrekingspunten op en slaat deze op in de $B variabele. Als u de parameter Onderbrekingspunt gebruikt, Enable-PSBreakpoint worden de onderbrekingspunten ingeschakeld.

Dit voorbeeld is gelijk aan uitvoeren Enable-PSBreakpoint -Id 3, 5.

Parameters

-Breakpoint

Hiermee geeft u de onderbrekingspunten op die moeten worden ingeschakeld. Geef een variabele op die onderbrekingspunten bevat of een opdracht waarmee onderbrekingspuntobjecten worden opgehaald, zoals Get-PSBreakpoint. U kunt ook onderbrekingspuntobjecten doorsluisen naar Enable-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 de id-nummers van de onderbrekingspunten die moeten worden ingeschakeld. De standaardwaarde is alle onderbrekingspunten. Geef de id op op getal of in een variabele. U kunt id-nummers niet doorsluisen naar Enable-PSBreakpoint. Gebruik de Get-PSBreakpoint cmdlet om de id van een onderbrekingspunt te vinden.

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

Retourneert een object dat het onderbrekingspunt aangeeft dat wordt ingeschakeld. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
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 een onderbrekingspuntobject doorsluisen naar Enable-PSBreakpoint.

Uitvoerwaarden

None or System.Management.Automation.Breakpoint

Wanneer u de parameter PassThru gebruikt, Enable-PSBreakpoint retourneert u een onderbrekingspuntobject dat dat onderbrekingspunt vertegenwoordigt dat is ingeschakeld. Anders genereert deze cmdlet geen uitvoer.

Notities

  • De Enable-PSBreakpoint cmdlet genereert geen fout als u probeert een onderbrekingspunt in te schakelen dat al is ingeschakeld. Als zodanig kunt u alle onderbrekingspunten zonder fouten inschakelen, zelfs als er slechts een paar zijn uitgeschakeld.

  • Onderbrekingspunten worden ingeschakeld wanneer u ze maakt met behulp van de Set-PSBreakpoint cmdlet. U hoeft nieuw gemaakte onderbrekingspunten niet in te schakelen.