Freigeben über

Disable-PSBreakpoint

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Deaktiviert die Haltepunkte in der aktuellen Konsole.

Syntax

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Disable-PSBreakpoint deaktiviert Haltepunkte, wodurch sichergestellt wird, dass sie beim Ausführen des Skripts nicht getroffen 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. Verwenden Sie das Cmdlet Enable-PSBreakpoint, um einen Haltepunkt erneut zu aktivieren. 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 zum Debuggen von PowerShell-Skripts. Weitere Informationen zum PowerShell-Debugger finden Sie unter about_Debuggers.

Beispiele

Beispiel 1: Festlegen eines Haltepunkts und Deaktivieren

Mit diesen Befehlen wird ein neu erstellter Haltepunkt deaktiviert.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Das Cmdlet Set-PSBreakpoint erstellt einen Haltepunkt für die $Name Variable im skript Sample.ps1 und speichert das Haltepunktobjekt in der $B Variablen. Das Cmdlet Disable-PSBreakpoint deaktiviert den neuen Haltepunkt. Es verwendet einen Pipelineoperator (|), um das Haltepunktobjekt in $B an das cmdlet Disable-PSBreakpoint zu senden.

Als Ergebnis dieses Befehls ist der Wert der eigenschaft Enabled des Haltepunktobjekts in $BFalse.

Beispiel 2: Deaktivieren eines Haltepunkts

Mit diesem Befehl wird der Haltepunkt mit der Haltepunkt-ID 0 deaktiviert.

Disable-PSBreakpoint -Id 0

Beispiel 3: Erstellen eines deaktivierten Haltepunkts

Dieser Befehl erstellt einen neuen Haltepunkt, der deaktiviert ist, bis Sie ihn aktivieren.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Es verwendet das Cmdlet Disable-PSBreakpoint, um den Haltepunkt zu deaktivieren. Der Wert des Breakpoint-Parameters ist ein Set-PSBreakpoint Befehl, der einen neuen Haltepunkt festlegt, ein Haltepunktobjekt generiert und das Objekt in der $B Variablen 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 in diesem Fall Set-PSBreakpoint ein Haltepunktobjekt generiert, kann es als Wert des Breakpoint-Parameters verwendet werden.

Beispiel 4: Deaktivieren aller Haltepunkte in der aktuellen Konsole

Mit diesem Befehl werden alle Haltepunkte in der aktuellen Konsole deaktiviert.

`Get-PSBreakpoint` | Disable-PSBreakpoint

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 auch Haltepunktobjekte an das Cmdlet Disable-PSBreakpoint weiterleiten.

Typ:Breakpoint[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

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 an Disable-PSBreakpointweitergeleitet werden.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das die aktivierten Haltepunkte darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Breakpoint

Sie können ein Haltepunktobjekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Breakpoint

Wenn Sie den PassThru--Parameter verwenden, gibt dieses Cmdlet ein Haltepunktobjekt zurück, das den deaktivierten Haltepunkt darstellt.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Disable-PSBreakpoint:

  • dbp