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 Disable-PSBreakpoint Cmdlet deaktiviert Haltepunkte, wodurch sichergestellt wird, dass sie nicht erreicht werden, wenn das Skript ausgeführt wird. Sie können es verwenden, um alle Haltepunkte zu deaktivieren, oder Sie können Haltepunkte durch Senden der Haltepunktobjekte oder Haltepunkt-IDs angeben.

Aus technischer Sicht ändert dieses Cmdlet den Wert der Enabled-Eigenschaft eines Haltepunktobjekts zu „False“. Verwenden Sie das Enable-PSBreakpoint Cmdlet, um einen Haltepunkt erneut zu aktivieren. Haltepunkte sind standardmäßig aktiviert, wenn Sie sie mithilfe des Set-PSBreakpoint Cmdlets erstellen.

Ein Haltepunkt ist ein Punkt in einem Skript, an dem die Ausführung vorübergehend beendet wird, damit die Anweisungen im Skript überprüft werden können. Disable-PSBreakpoint ist eines von mehreren Cmdlets, die zum Debuggen von PowerShell-Skripts entwickelt wurden. Weitere Informationen zum PowerShell-Debugger finden Sie unter about_Debuggers.

Beispiele

Beispiel 1: Festlegen eines Haltepunkts und Deaktivieren

Diese Befehle deaktivieren einen neu erstellten Haltepunkt.

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

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

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

Beispiel 2: Deaktivieren eines Haltepunkts

Dieser Befehl deaktiviert den Haltepunkt mit der Haltepunkt-ID 0.

Disable-PSBreakpoint -Id 0

Beispiel 3: Create 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 Disable-PSBreakpoint Cmdlet, 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 annehmen, 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 wird, kann es als Wert des Breakpoint-Parameters verwendet werden.

Beispiel 4: Deaktivieren aller Haltepunkte in der aktuellen Konsole

Dieser Befehl deaktiviert alle Haltepunkte in der aktuellen Konsole.

`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 Breakpointobjekte an das Disable-PSBreakpoint Cmdlet übergeben.

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Deaktiviert die Haltepunkte mit den angegebenen Haltepunkt-IDs. Geben Sie die IDs oder eine Variable ein, die die IDs enthält. Sie können keine IDs an übergeben Disable-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Breakpoint

Sie können ein Breakpointobjekt an übergeben Disable-PSBreakpoint.

Ausgaben

None or System.Management.Automation.Breakpoint

Wenn Sie den PassThru-Parameter verwenden, gibt ein -Objekt zurück, Disable-PSBreakpoint das den deaktivierten Haltepunkt darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.