Enable-PSBreakpoint

  • Referens
Modul:
Microsoft.PowerShell.Utility

Aktiverar brytpunkterna i den aktuella konsolen.

Syntax

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

Description

Cmdleten Enable-PSBreakpoint aktiverar inaktiverade brytpunkter igen. Du kan använda den för att aktivera alla brytpunkter eller specifika brytpunkter genom att tillhandahålla brytpunktsobjekt eller ID:t.

En brytpunkt är en punkt i ett skript där körningen stoppas tillfälligt så att du kan undersöka tillståndet för skriptet. Nyligen skapade brytpunkter aktiveras automatiskt, men kan inaktiveras med hjälp av Disable-PSBreakpoint.

Tekniskt sett ändrar den här cmdleten värdet för egenskapen Enabled för ett brytpunktsobjekt till True.

Enable-PSBreakpoint är en av flera cmdletar som är utformade för felsökning av PowerShell-skript. Mer information om PowerShell-felsökningsprogrammet finns i about_Debuggers.

Exempel

Exempel 1: Aktivera alla brytpunkter

Det här exemplet aktiverar alla brytpunkter i den aktuella sessionen.

Get-PSBreakpoint | Enable-PSBreakpoint

Med hjälp av alias kan det här exemplet förkortas som gbp | ebp.

Exempel 2: Aktivera brytpunkter efter ID

Det här exemplet aktiverar flera brytpunkter med hjälp av deras brytpunkts-ID: n.

Enable-PSBreakpoint -Id 0, 1, 5

Exempel 3: Aktivera en inaktiverad brytpunkt

I det här exemplet återaktiveras en brytpunkt som har inaktiverats.

$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 skapar en brytpunkt för variabeln Name i Sample.ps1-skriptet och sparar brytpunktsobjektet i variabeln $B. Parametern PassThru visar värdet för egenskapen Enabled för brytpunkten är False.

Enable-PSBreakpoint återaktiver brytpunkten. Med parametern PassThru ser vi återigen att värdet för egenskapen Enabled är True.

Exempel 4: Aktivera brytpunkter med hjälp av en variabel

Det här exemplet aktiverar en uppsättning brytpunkter med hjälp av brytpunktsobjekten.

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

Get-PSBreakpoint hämtar brytpunkterna och sparar dem i variabeln $B. Med parametern Brytpunkt aktiverar Enable-PSBreakpoint brytpunkterna.

Det här exemplet motsvarar att köra Enable-PSBreakpoint -Id 3, 5.

Parametrar

-Breakpoint

Anger vilka brytpunkter som ska aktiveras. Ange en variabel som innehåller brytpunkter eller ett kommando som hämtar brytpunktsobjekt, till exempel Get-PSBreakpoint. Du kan också skicka brytpunktsobjekt till Enable-PSBreakpoint.

Typ:Breakpoint[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger ID antal brytpunkter som ska aktiveras. Standardvärdet är alla brytpunkter. Ange -ID:t efter tal eller i en variabel. Du kan inte skicka ID tal till Enable-PSBreakpoint. Använd cmdleten Get-PSBreakpoint för att hitta -ID:t för en brytpunkt.

Typ:Int32[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar brytpunkten som aktiveras. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

Breakpoint

Du kan skicka ett brytpunktsobjekt till Enable-PSBreakpoint.

Utdata

None or System.Management.Automation.Breakpoint

När du använder parametern PassThru returnerar Enable-PSBreakpoint ett brytpunktsobjekt som representerar brytpunkten som har aktiverats. Annars genererar den här cmdleten inga utdata.

Kommentarer

  • Cmdleten Enable-PSBreakpoint genererar inget fel om du försöker aktivera en brytpunkt som redan är aktiverad. Därför kan du aktivera alla brytpunkter utan fel, även om bara ett fåtal är inaktiverade.

  • Brytpunkter aktiveras när du skapar dem med hjälp av cmdleten Set-PSBreakpoint. Du behöver inte aktivera nyligen skapade brytpunkter.