Freigeben über

Enable-PSBreakpoint

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Aktiviert die Haltepunkte in der aktuellen Konsole.

Syntax

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

Beschreibung

Mit dem Cmdlet Enable-PSBreakpoint werden deaktivierte Haltepunkte erneut aktiviert. 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 eigenschaft Enabled 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 gbp | ebpabgekürzt werden.

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 variable Name im skript Sample.ps1, der das Haltepunktobjekt in der $B Variablen speichert. Der parameter PassThru zeigt den Wert der Enabled-Eigenschaft des Haltepunkts Falsean.

Enable-PSBreakpoint den Haltepunkt erneut aktiviert. Erneut wird mithilfe des PassThru- Parameters angezeigt, dass der Wert der eigenschaft EnabledTrueist.

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 variablen $B. Mithilfe des Haltepunkt--Parameters aktiviert Enable-PSBreakpoint die Haltepunkte.

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

Parameter

-Breakpoint

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

Typ:Breakpoint[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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. Sie können ID- Nummern nicht an Enable-PSBreakpointweitergeleitet werden. Verwenden Sie das cmdlet Get-PSBreakpoint, um die -ID eines Haltepunkts zu finden.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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 parameter PassThru verwenden, gibt dieses Cmdlet ein Haltepunktobjekt zurück, das den aktivierten Haltepunkt darstellt.

Hinweise

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

  • ebp

  • Das Cmdlet Enable-PSBreakpoint 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 sind aktiviert, wenn Sie sie mithilfe des Cmdlets Set-PSBreakpoint erstellen. Sie müssen keine neu erstellten Haltepunkte aktivieren.