Deaktiviert die Haltepunkte in der aktuellen Konsole.
Syntax
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Disable-PSBreakpoint" werden Haltepunkte deaktiviert. Dies gewährleistet, dass sie nicht erreicht werden, wenn das Skript ausgeführt wird. Sie können alle Haltepunkte deaktivieren, oder Sie können Haltepunkte angeben, indem Sie Haltepunktobjekte oder Haltepunkt-IDs senden.
Technisch gesehen wird mit diesem Cmdlet der Wert der Enabled-Eigenschaft eines Haltepunktobjekts in False geändert. Um einen Haltepunkt erneut zu aktivieren, verwenden Sie das Cmdlet "Enable-PSBreakpoint". Haltepunkte sind standardmäßig aktiviert, wenn Sie sie mit dem Cmdlet "Set-PSBreakpoint" erstellen.
Ein Haltepunkt ist ein Punkt in einem Skript, an dem die Ausführung unterbrochen wird, damit Sie die Anweisungen im Skript untersuchen können. Disable-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 deaktivierenden 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 das Cmdlet "Disable-PSBreakpoint" übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
keine |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Id <Int32[]>
Deaktiviert die Haltepunkte mit den angegebenen Haltepunkt-IDs. Geben Sie die IDs oder eine Variable ein, die die IDs enthält. IDs können nicht über die Pipeline an Disable-PSBreakpoint übergeben werden.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-PassThru
Gibt ein Objekt zurück, das die aktivierten Haltepunkte darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
keine |
|
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 Disable-PSBreakpoint übergeben. |
|
Ausgaben |
Keiner oder System.Management.Automation.Breakpoint Wenn Sie den PassThru-Parameter verwenden, gibt Disable-PSBreakpoint ein Objekt zurück, das den deaktivierten Haltepunkt darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Beispiel 1
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name C:\PS> $b | disable-psbreakpoint Beschreibung ----------- Mit diesen Befehlen wird ein neu erstellter Haltepunkt deaktiviert. 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. Als Ergebnis dieses Befehls hat die Enabled-Eigenschaft des Haltepunktobjekts in "$b" den Wert "False".
Beispiel 2
C:\PS>disable-psbreakpoint -id 0 Beschreibung ----------- Mit diesem Befehl wird der Haltepunkt mit der Haltepunkt-ID 0 deaktiviert.
Beispiel 3
C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) C:\PS> $b Beschreibung ----------- Mit diesem Befehl wird ein neuer Haltepunkt erstellt, der deaktiviert ist, bis Sie ihn aktivieren. Der Haltepunkt wird mit dem Cmdlet "Disable-PSBreakpoint" deaktiviert. Der Wert des Breakpoint-Parameters ist der Befehl "Set-PSBreakpoint". Mit diesem wird ein neuer Haltepunkt festgelegt, ein Haltepunktobjekt generiert und das Objekt in der Variablen "$b" gespeichert. Cmdlet-Parameter, die Objekte als Werte annehmen, akzeptieren eine Variable, die das Objekt enthält, oder einen Befehl, der das Objekt abruft oder generiert. In diesem Fall kann Set-PSBreakpoint als Wert des Breakpoint-Parameters verwendet werden, da der Befehl ein Haltepunktobjekt generiert. Mit dem zweiten Befehl wird das Haltepunktobjekt im Wert der Variablen "$b" angezeigt.
Beispiel 4
C:\PS>get-psbreakpoint | disable-psbreakpoint Beschreibung ----------- Mit diesem Befehl werden alle Haltepunkte in der aktuellen Konsole deaktiviert. Sie können für diesen Befehl die Kurzform "gbp | dbp" verwenden.
Siehe auch