Enable-PSBreakpoint

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

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

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.

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.

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

Enable-PSBreakpoint -Id 0, 1, 5

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.

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.

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 naar Enable-PSBreakpoint om het onderbrekingspunt in de runspace in te 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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een onderbrekingspuntobject doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

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

PowerShell bevat de volgende aliassen voor Enable-PSBreakpoint:

• Alle platforms:

  • 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.