Enable-PSBreakpoint
Hiermee schakelt u de onderbrekingspunten in de huidige console in.
Syntax
Breakpoint (Standaard)
Enable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Enable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met de Enable-PSBreakpoint cmdlet worden uitgeschakelde onderbrekingspunten opnieuw ingeschakeld. 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 behulp van 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 Naam in het Sample.ps1 script waarmee 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. Wederom zien we dat de waarde van de eigenschap Ingeschakeldwaar is met behulp van de parameter PassThru.
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 het uitvoeren Enable-PSBreakpoint -Id 3, 5.
Voorbeeld 5: Een onderbrekingspunt inschakelen in een runspace
In dit voorbeeld wordt een taak gestart met een onderbrekingspunt en uitgeschakeld. De runspace wordt opgeslagen in een variabele en doorgegeven aan de opdracht Get-PSBreakpoint met de parameter Runspace.
De uitvoer van Get-PSBreakpoint wordt doorgesluisd om het onderbrekingspunt in de runspace in te Enable-PSBreakpoint schakelen.
Start-Job -ScriptBlock {
$bp = Set-PSBreakpoint -Command Start-Sleep
Disable-PSBreakpoint $bp
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakpoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace
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 Enable-PSBreakpointnaar .
Parametereigenschappen
| Type: | |
| 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-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.
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 |
-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.
Parametereigenschappen
| Type: | Runspace |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | RunspaceId |
Parametersets
Id
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| 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
PowerShell bevat de volgende aliassen voor Enable-PSBreakpoint:
Alle platforms:
ebp
De
Enable-PSBreakpointcmdlet genereert geen fout als u een onderbrekingspunt probeert 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-PSBreakpointcmdlet. U hoeft nieuw gemaakte onderbrekingspunten niet in te schakelen.