Freigeben über

Enable-PSBreakpoint

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Aktiviert die Haltepunkte in der aktuellen Konsole.

Syntax

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-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 Haltepunktobjekte 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 gesehen ändert dieses Cmdlet den Wert der Enabled-Eigenschaft eines Haltepunktobjekts in True.

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

Beispiele

Beispiel 1: Aktivieren aller Haltepunkte

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

Get-PSBreakpoint | Enable-PSBreakpoint

Unter 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 deaktivierter Haltepunkt erneut aktiviert.

$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 Sample.ps1 Skript und speichert das Haltepunktobjekt in der $B Variablen. Der PassThru-Parameter zeigt den Wert der Enabled-Eigenschaft des Haltepunkts auf False an.

Enable-PSBreakpoint aktiviert den Haltepunkt erneut. Auch bei Verwendung des PassThru-Parameters wird angezeigt, dass der Wert der Enabled-EigenschaftTrue ist.

Beispiel 4: Aktivieren von Haltepunkten mithilfe einer Variablen

In diesem Beispiel wird eine Gruppe 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 BreakpointparametersEnable-PSBreakpoint werden die Haltepunkte aktiviert.

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

Beispiel 5: Aktivieren eines Haltepunkts in einem Runspace

In diesem Beispiel wird ein Auftrag mit einem Haltepunkt gestartet und dann deaktiviert. Der Runspace wird in einer Variablen gespeichert und mit dem Runspace-Parameter an den Get-PSBreakPoint-Befehl übergeben. Die Ausgabe von Get-PSBreakPoint wird an übergeben, 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 enthält, oder einen Befehl, mit dem Haltepunktobjekte abgerufen werden, z. B Get-PSBreakpoint. . Sie können auch Breakpointobjekte an übergeben Enable-PSBreakpoint.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Id

Gibt die ID-Nummern der zu aktivierenden Haltepunkte an. Standardmäßig werden alle Haltepunkte aktiviert. Geben Sie die ID nach Zahl oder in einer Variablen an. Sie können keine Id-Nummern an übergeben Enable-PSBreakpoint. Verwenden Sie das Cmdlet, um die ID eines Haltepunkts Get-PSBreakpoint zu ermitteln.

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

-PassThru

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

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

-Runspace

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

Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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. Auf diese Weise 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. Neu erstellte Haltepunkte müssen nicht aktiviert werden.