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 återaktiverade inaktiverade brytpunkter. 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 skriptets tillstånd. Nyligen skapade brytpunkter aktiveras automatiskt, men kan inaktiveras med hjälp av Disable-PSBreakpoint.

Tekniskt sett ändrar denna cmdlet 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 till gbp | ebp.

Exempel 2: Aktivera brytpunkter efter ID

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

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

Enable-PSBreakpoint återaktivering av brytpunkten. Med hjälp av 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 hjälp av brytpunktsparameternEnable-PSBreakpoint aktiverar brytpunkterna.

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

Parametrar

-Breakpoint

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

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Returnerar ett objekt som representerar brytpunkten som aktiveras. Som standard genererar denna cmdlet inga utdata.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

Breakpoint

Du kan skicka ett brytpunktsobjekt till Enable-PSBreakpoint.

Utdata

None or System.Management.Automation.Breakpoint

När du använder parametern Enable-PSBreakpointPassThru returnerar ett brytpunktsobjekt som representerar brytpunkten som har aktiverats. Annars genererar denna cmdlet 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 några få är inaktiverade.

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