Disable-PSBreakpoint
Deaktiviert die Haltepunkte in der aktuellen Konsole.
Syntax
Breakpoint (Standard)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Disable-PSBreakpoint deaktiviert Haltepunkte, wodurch sichergestellt wird, dass sie beim Ausführen des Skripts nicht erreicht werden. Sie können sie verwenden, um alle Haltepunkte zu deaktivieren, oder Sie können Haltepunkte angeben, indem Sie Haltepunktobjekte oder Haltepunkt-IDs übermitteln.
Technisch ändert dieses Cmdlet den Wert der Enabled-Eigenschaft eines Haltepunktobjekts in False. 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 vorübergehend beendet wird, damit Sie die Anweisungen im Skript untersuchen können. Disable-PSBreakpoint ist eines von mehreren Cmdlets, die zum Debuggen von Windows PowerShell-Skripts entwickelt wurden. Weitere Informationen zum Windows PowerShell-Debugger finden Sie unter about_Debuggers.
Beispiele
Beispiel 1: Festlegen eines Haltepunkts und Deaktivieren
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint
Mit diesen Befehlen wird ein neu erstellter Haltepunkt deaktiviert.
Im ersten Befehl wird das Cmdlet Set-PSBreakpoint verwendet, um einen Haltepunkt für die Variable Name im Sample.ps1 Skript zu erstellen. Anschließend wird das Haltepunktobjekt in der Variablen $B gespeichert.
Der zweite Befehl verwendet das Cmdlet Disable-PSBreakpoint , um den neuen Haltepunkt zu deaktivieren. Er verwendet einen Pipelineoperator (|), um das Haltepunktobjekt in $B an das Cmdlet Disable-PSBreakpoint zu senden.
Als Ergebnis dieses Befehls ist der Wert der Enabled-Eigenschaft des Haltepunktobjekts in $B False.
Beispiel 2: Deaktivieren eines Haltepunkts
PS C:\> Disable-PSBreakpoint -Id 0
Mit diesem Befehl wird der Haltepunkt mit der Haltepunkt-ID 0 deaktiviert.
Beispiel 3: Erstellen eines deaktivierten Haltepunkts
PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B
Dieser Befehl erstellt einen neuen Haltepunkt, der deaktiviert ist, bis Sie ihn aktivieren.
Der Haltepunkt wird mit dem Cmdlet Disable-PSBreakpoint deaktiviert. Der Wert des Haltepunktparameters ist ein Set-PSBreakpoint Befehl, der einen neuen Haltepunkt festlegt, ein Haltepunktobjekt generiert und das Objekt in der Variablen $B speichert.
Cmdlet-Parameter, die Objekte als Werte verwenden, können eine Variable akzeptieren, die das Objekt enthält, oder einen Befehl, der das Objekt abruft oder generiert. Da Set-PSBreakpoint in diesem Fall ein Haltepunktobjekt generiert, kann es als Wert des Breakpoint-Parameters verwendet werden.
Der zweite Befehl zeigt das Haltepunktobjekt im Wert der Variablen $B an.
Beispiel 4: Deaktivieren aller Haltepunkte in der aktuellen Konsole
PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint
Mit diesem Befehl werden alle Haltepunkte in der aktuellen Konsole deaktiviert. Sie können diesen Befehl abkürzen als: "gbp | dbp".
Parameter
-Breakpoint
Gibt die zu deaktivierenden Haltepunkte an. Geben Sie eine Variable ein, die Haltepunktobjekte enthält, oder einen Befehl, der Haltepunktobjekte abruft, z. B. einen Get-PSBreakpoint-Befehl. Sie können Haltepunktobjekte auch über die Pipeline an das Cmdlet Disable-PSBreakpoint übergeben.
Parametereigenschaften
| Typ: | Breakpoint[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Breakpoint
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Id
Gibt ein Array von IDs oder Variablen an, das die Haltepunkt-IDs enthält. IDs können nicht über die Pipeline an Disable-PSBreakpoint übergeben werden.
Parametereigenschaften
| Typ: | Int32[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Id
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
Breakpoint
Sie können ein Haltepunktobjekt über die Pipeline an Disable-PSBreakpoint übergeben.
Ausgaben
None or System.Management.Automation.Breakpoint
Wenn Sie den PassThru-Parameter verwenden, gibt Disable-PSBreakpoint ein Objekt zurück, das den deaktivierten Haltepunkt darstellt. Andernfalls generiert dieses Cmdlet keine Ausgabe.