Delen via

Enable-PSBreakpoint

Module:
Microsoft.PowerShell.Utility Module

Hiermee schakelt u de onderbrekingspunten in de huidige console in.

Syntax

Id (Standaard) 

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

Breakpoint 

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

Description

De Enable-PSBreakpoint cmdlet schakelt uitgeschakelde onderbrekingspunten opnieuw in. U kunt dit 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 Disable-PSBreakpoint.

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

Enable-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 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 opnieuw ingeschakeld dat is uitgeschakeld.

$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 Name in het Sample.ps1 script waarmee het onderbrekingspuntobject wordt opgeslagen in de $B variabele. De parameter PassThru geeft de waarde weer van de eigenschap Ingeschakeld van het onderbrekingspunt is Onwaar.

Enable-PSBreakpoint het onderbrekingspunt opnieuw inschakelt. Nogmaals, met behulp van de parameter PassThru zien we dat de waarde van de eigenschap Ingeschakeld is Waar.

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, schakelt de onderbrekingspunten in.

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

Parameters

-Breakpoint

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

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

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
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 een onderbrekingspuntobject doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

Breakpoint

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een onderbrekingspuntobject dat het ingeschakelde onderbrekingspunt vertegenwoordigt.

Notities

Windows PowerShell bevat de volgende aliassen voor Enable-PSBreakpoint:

  • ebp

  • 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 cmdlet Set-PSBreakpoint. U hoeft nieuw gemaakte onderbrekingspunten niet in te schakelen.