Aktiviert die Haltepunkte in der aktuellen Konsole.
Syntax
Enable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>] Enable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Enable-PSBreakpoint" werden deaktivierte Haltepunkte erneut aktiviert. Sie können mit dem Cmdlet alle Haltepunkte aktivieren, oder Sie können Haltepunkte angeben, indem Sie Haltepunktobjekte oder Haltepunkt-IDs senden.
Ein Haltepunkt ist ein Punkt in einem Skript, an dem die Ausführung unterbrochen wird, damit Sie die Anweisungen im Skript untersuchen können. Neu erstellte Haltepunkte werden automatisch aktiviert, Sie können sie jedoch mit dem Cmdlet "Disable-PSBreakpoint" deaktivieren.
Technisch gesehen wird mit diesem Cmdlet der Wert der Enabled-Eigenschaft eines Haltepunktobjekts in True geändert.
Enable-PSBreakpoint ist eines von mehreren Cmdlets zum Debuggen von Windows PowerShell-Skripten. Weitere Informationen über den Windows PowerShell-Debugger finden Sie unter "about_Debuggers".
Parameter
-Breakpoint <Breakpoint[]>
Gibt die zu aktivierenden Haltepunkte an. Geben Sie eine Variable ein, die Haltepunktobjekte enthält, oder einen Befehl zum Abrufen von Haltepunktobjekten, z. B. den Befehl "Get-PSBreakpoint". Sie können Haltepunktobjekte auch über die Pipeline an Enable-PSBreakpoint übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
None. |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Id <Int32[]>
Aktiviert Haltepunkte, die über die angegebenen Haltepunkt-IDs verfügen. Standardmäßig werden alle Haltepunkte aktiviert. Geben Sie die IDs oder eine Variable ein, die die IDs enthält. (IDs können nicht über die Pipeline an Enable-PSBreakpoint übergeben werden.) Mit dem Cmdlet "Get-PSBreakpoint" können Sie die ID eines Haltepunkts suchen.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
keine |
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-PassThru
Gibt ein Objekt zurück, das den aktivierten Haltepunkt darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
No output |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Management.Automation.Breakpoint Sie können ein Haltepunktobjekt über die Pipeline an Enable-PSBreakpoint übergeben. |
|
Ausgaben |
Keiner oder System.Management.Automation.Breakpoint Wenn Sie den PassThru-Parameter verwenden, gibt Enable-PSBreakpoint ein Haltepunktobjekt zurück, das den Haltepunkt darstellt, der aktiviert wurde. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Hinweise
Das Cmdlet "Enable-PSBreakpoint" generiert keinen Fehler, wenn Sie versuchen, einen Haltepunkt zu aktivieren, der bereits aktiviert ist. Sie können alle Haltepunkte ohne Fehler aktivieren, selbst wenn nur einige Haltepunkte deaktiviert sind.
Haltepunkte sind aktiviert, wenn Sie sie mit dem Cmdlet "Set-PSBreakpoint" erstellen. Sie müssen neu erstellte Haltepunkte nicht aktivieren.
Beispiel 1
C:\PS>get-psbreakpoint | enable-psbreakpoint Beschreibung ----------- Mit diesem Befehl werden alle Haltepunkte in der aktuellen Konsole aktiviert. Sie können für den Befehl die Kurzform "gbp | ebp" verwenden.
Beispiel 2
C:\PS>enable-psbreakpoint -id 0, 1, 5 Beschreibung ----------- Mit diesem Befehl werden Haltepunkte mit der Haltepunkt-ID 0, 1 und 5 aktiviert.
Beispiel 3
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name C:\PS> $b | disable-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 C:\PS> $b | enable-psbreakpoint -passthru AccessMode : Write Variable : Name Action : Enabled : True HitCount : 0 Id : 0 Script : C:\ps-test\sample.ps1 ScriptName : C:\ps-test\sample.ps1 Beschreibung ----------- Mit diesen Befehlen wird ein deaktivierter Haltepunkt erneut aktiviert. Im ersten Befehl wird ein Haltepunkt für die Variable "Name" im Skript "Sample.ps1" mit dem Cmdlet "Set-PSBreakpoint" erstellt. Dann wird das Haltepunktobjekt in der Variablen "$b" gespeichert. Im zweiten Befehl wird der neue Haltepunkt mit dem Cmdlet "Disable-PSBreakpoint" deaktiviert. Das Haltepunktobjekt in "$b" wird mit dem Pipelineoperator (|) an das Cmdlet "Disable-PSBreakpoint" gesendet, und mit dem PassThru-Parameter von Disable-PSBreakpoint wird das deaktivierte Haltepunktobjekt angezeigt. So können Sie überprüfen, ob der Wert der Enabled-Eigenschaft des Haltepunktobjekts False ist. Im dritten Befehl wird der Haltepunkt mit dem Cmdlet "Enable-PSBreakpoint" erneut aktiviert. Das Haltepunktobjekt in "$b" wird mit dem Pipelineoperator (|) an das Cmdlet "Enable-PSBreakpoint" gesendet, und mit dem PassThru-Parameter von Enable-PSBreakpoint wird das Haltepunktobjekt angezeigt. So können Sie überprüfen, ob der Wert der Enabled-Eigenschaft des Haltepunktobjekts True ist. Die Ergebnisse werden in der folgenden Beispielausgabe gezeigt.
Beispiel 4
C:\PS>$b = get-psbreakpoint -id 3, 5 C:\PS> enable-psbreakpoint -breakpoint $b Beschreibung ----------- Mit diesen Befehlen wird ein Satz von Haltepunkten aktiviert, indem ihre Haltepunktobjekte angegeben werden. Im ersten Befehl werden die Haltepunkte mit dem Cmdlet "Get-PSBreakpoint" abgerufen und in der Variablen "$b" gespeichert. Im zweiten Befehl werden die Haltepunkte mit dem Cmdlet "Enable-PSBreakpoint" und dem zugehörigen Breakpoint-Parameter aktiviert. Dieser Befehl entspricht der Verwendung von "enable-psbreakpoint -id 3, 5".
Siehe auch