Deaktiviert die Haltepunkte in der aktuellen Konsole. (Disable-PSBreakpoint)
NAME
Disable-PSBreakpoint
# ÜBERSICHT
Deaktiviert die Haltepunkte in der aktuellen Konsole.
# SYNTAX
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-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 Keiner
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 [<SwitchParameter>]
Gibt ein Objekt zurück, das die aktivierten Haltepunkte darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Erforderlich? false
Position? named
Standardwert Keiner
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-Confirm [<SwitchParameter>]
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-WhatIf [<SwitchParameter>]
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 folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "get-help about_commonparameters".
# 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.
# HINWEISE
# 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.
VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113294 (möglicherweise auf Englisch)
about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Remove-PSBreakpoint
Get-PSCallStack
C:\Windows>powershell get-help Get-PSCallStack -full
ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.