ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2009 Microsoft Corporation.
C:\Windows-7>Powershell get-help Disable-PSBreakpoint -full
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
