Enable-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Aktiviert die Haltepunkte in der aktuellen Konsole.

Syntax

Breakpoint (Standard) 

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

Id 

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

Beschreibung

Das Enable-PSBreakpoint Cmdlet aktiviert deaktivierte Haltepunkte erneut. Sie können es verwenden, um alle Haltepunkte oder bestimmte Haltepunkte zu aktivieren, indem Sie Haltepunkte oder IDs bereitstellen.

Ein Haltepunkt ist ein Punkt in einem Skript, an dem die Ausführung vorübergehend beendet wird, sodass Sie den Status des Skripts untersuchen können. Neu erstellte Haltepunkte werden automatisch aktiviert, können jedoch mit Disable-PSBreakpointdeaktiviert werden.

Technisch ändert dieses Cmdlet den Wert der Enabled-Eigenschaft eines Haltepunktobjekts in True.

Enable-PSBreakpoint ist eines von mehreren Cmdlets zum Debuggen von PowerShell-Skripts. Weitere Informationen zum PowerShell-Debugger finden Sie unter about_Debuggers.

Beispiele

Beispiel 1: Alle Haltepunkte aktivieren

In diesem Beispiel werden alle Haltepunkte in der aktuellen Sitzung aktiviert.

Get-PSBreakpoint | Enable-PSBreakpoint

Bei Verwendung von Aliasen kann dieses Beispiel als abgekürzt werden gbp | ebp.

Beispiel 2: Aktivieren von Haltepunkten nach ID

In diesem Beispiel werden mehrere Haltepunkte mithilfe ihrer Haltepunkt-IDs aktiviert.

Enable-PSBreakpoint -Id 0, 1, 5

Beispiel 3: Aktivieren eines deaktivierten Haltepunkts

In diesem Beispiel wird ein Haltepunkt erneut aktiviert, der deaktiviert wurde.

$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 erstellt einen Haltepunkt für die Name-Variable im Skript, in dem Sample.ps1 das Haltepunktobjekt in der $B Variablen gespeichert wird. Der PassThru-Parameter zeigt den Wert der Enabled-Eigenschaft des Haltepunkts "False" an.

Enable-PSBreakpoint aktiviert den Haltepunkt erneut. Auch hier wird mithilfe des PassThru-Parameters angezeigt, dass der Wert der Enabled-Eigenschaft"True" lautet.

Beispiel 4: Aktivieren von Haltepunkten mithilfe einer Variablen

In diesem Beispiel wird eine Reihe von Haltepunkten mithilfe der Haltepunktobjekte aktiviert.

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

Get-PSBreakpoint ruft die Haltepunkte ab und speichert sie in der $B Variablen. Mithilfe des Breakpoint-ParametersEnable-PSBreakpoint werden die Haltepunkte aktiviert.

Dieses Beispiel entspricht der Ausführung Enable-PSBreakpoint -Id 3, 5.

Beispiel 5: Aktivieren eines Haltepunkts in einem Runspace

In diesem Beispiel wird ein Auftrag mit einem Haltepunkt gestartet, um dann deaktiviert zu werden. Der Runspace wird in einer Variablen gespeichert und mit dem parameter Get-PSBreakpoint an den befehl übergeben. Die Ausgabe von Get-PSBreakpoint wird weitergeleitet, um Enable-PSBreakpoint den Haltepunkt im Runspace zu aktivieren.

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

Parameter

-Breakpoint

Gibt die zu aktivierenden Haltepunkte an. Stellen Sie eine Variable bereit, die Haltepunkte oder einen Befehl enthält, der Haltepunktobjekte abruft, z Get-PSBreakpoint. B. . Sie können auch Haltepunktobjekte an Enable-PSBreakpoint.

Parametereigenschaften

Typ:

Breakpoint[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Breakpoint
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt die ID-Nummern der zu aktivierenden Haltepunkte an. Der Standardwert ist alle Haltepunkte. Geben Sie die ID nach Zahl oder in einer Variablen an. Id-Nummern können nicht weitergeleitet werden.Enable-PSBreakpoint Verwenden Sie das Get-PSBreakpoint Cmdlet, um die ID eines Haltepunkts zu finden.

Parametereigenschaften

Typ:

Int32[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Id
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt ein Objekt zurück, das den aktivierten Haltepunkt darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Runspace

Gibt die ID eines Runspace- -Objekts an, sodass Sie mit Haltepunkten im angegebenen Runspace interagieren können.

Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.

Parametereigenschaften

Typ:Runspace
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:RunspaceId

Parametersätze

Id
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Breakpoint

Sie können ein Haltepunktobjekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Breakpoint

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein Haltepunktobjekt zurück, das den aktivierten Haltepunkt darstellt.

Hinweise

PowerShell enthält die folgenden Aliase für Enable-PSBreakpoint:

  • Alle Plattformen:

    • ebp

  • Das Enable-PSBreakpoint Cmdlet generiert keinen Fehler, wenn Sie versuchen, einen bereits aktivierten Haltepunkt zu aktivieren. Daher können Sie alle Haltepunkte ohne Fehler aktivieren, auch wenn nur wenige deaktiviert sind.

  • Haltepunkte werden aktiviert, wenn Sie sie mithilfe des Set-PSBreakpoint Cmdlets erstellen. Sie müssen keine neu erstellten Haltepunkte aktivieren.