Disable-PSBreakpoint
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 nicht getroffen 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“. Um einen Haltepunkt wieder zu aktivieren, verwenden Sie das Enable-PSBreakpoint-Cmdlet. 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
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint
Diese Befehle deaktivieren einen neu erstellten Haltepunkt.
Der erste Befehl verwendet das Cmdlet Set-PSBreakpoint, 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. Es 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
Dieser Befehl deaktiviert den Haltepunkt mit der Haltepunkt-ID 0.
Beispiel 3: Create 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.
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 variablen $B 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 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
Dieser Befehl deaktiviert alle Haltepunkte in der aktuellen Konsole. Sie können diesen Befehl wie folgt abkürten: "gbp | dbp".
Parameter
-Breakpoint
Gibt die zu deaktivierenden Haltepunkte an. Geben Sie eine Variable ein, die Haltepunktobjekte enthält, bzw. einen Befehl, der Haltepunktobjekte abruft, wie z. B. einen Get-PSBreakpoint-Befehl. Sie können breakpoint-Objekte auch an das Cmdlet Disable-PSBreakpoint ü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 Disable-PSBreakpoint übergeben.
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
Sie können ein Breakpointobjekt 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 wird von diesem Cmdlet keine Ausgabe generiert.