Dela via

Enable-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Aktiverar brytpunkterna i den aktuella konsolen.

Syntax

Id (Standard) 

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

Breakpoint 

Enable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-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.

Parameteregenskaper

Typ:

Breakpoint[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Breakpoint
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 för att hitta Get-PSBreakpoint för en brytpunkt.

Parameteregenskaper

Typ:

Int32[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Id
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

Breakpoint

Du kan skicka ett brytpunktsobjekt till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

Breakpoint

När du använder parametern PassThru returnerar den här cmdleten ett brytpunktsobjekt som representerar den aktiverade brytpunkten.

Kommentarer

Windows PowerShell innehåller följande alias för Enable-PSBreakpoint:

  • ebp

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