Deaktiviert die Haltepunkte in der aktuellen Konsole. (Disable-PSBreakpoint)
NAMEDisable-PSBreakpointÜBERSICHTDeaktiviert die Haltepunkte in der aktuellen Konsole.SYNTAXDisable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]BESCHREIBUNGMit 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".EINGABENSystem.Management.Automation.Breakpoint Sie können ein Haltepunktobjekt über die Pipeline an Disable-PSBreakpoint übergeben.AUSGABENKeiner 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.HINWEISEBeispiele
BEISPIEL 1C:\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 2C:\PS>disable-psbreakpoint -id 0 Beschreibung ----------- Mit diesem Befehl wird der Haltepunkt mit der Haltepunkt-ID 0 deaktiviert.BEISPIEL 3C:\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 4C:\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
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
