Dela via

Enable-PSBreakpoint

  • Referens
Modul:
Microsoft.PowerShell.Utility

Aktiverar brytpunkterna i den aktuella konsolen.

Syntax

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

Description

Cmdleten Enable-PSBreakpoint återaktiverade 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 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 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 parametern Enable-PSBreakpoint Breakpoint aktiverar du brytpunkterna.

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

Exempel 5: Aktivera en brytpunkt i ett runspace

I det här exemplet startas ett jobb med en brytpunkt som ska brytas och inaktiveras. Runspace lagras i en variabel och skickas Get-PSBreakPoint till kommandot med parametern Runspace . Utdata Get-PSBreakPoint från skickas till för att Enable-PSBreakpoint aktivera brytpunkten i runspace.

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

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-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. Om du vill hitta ID:t för en brytpunkt använder du cmdletenGet-PSBreakpoint.

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

-Runspace

Anger ID för ett Runspace-objekt så att du kan interagera med brytpunkter i det angivna körningsutrymmet.

Den här parametern lades till i PowerShell 7.2.

Typ:Runspace
Alias:RunspaceId
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. 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 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

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

  • Alla plattformar:

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