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