Disable-PSBreakpoint
Deaktiviert die Haltepunkte in der aktuellen Konsole.
Syntax
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Disable-PSBreakpoint
Cmdlet 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“.
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 $B
False.
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 Breakpointparameters 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 Breakpointparameters verwendet werden.
Beispiel 4: Deaktivieren aller Haltepunkte in der aktuellen Konsole
Dieser Befehl deaktiviert alle Haltepunkte in der aktuellen Konsole.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Beispiel 5: Deaktivieren eines Haltepunkts in einem Runspace
In diesem Beispiel wird ein Auftrag gestartet und ein Haltepunkt ist für die Ausführung des Set-PSBreakPoint
festgelegt. Der Runspace wird in einer Variablen gespeichert und mit dem Runspace-Parameter an den Get-PSBreakPoint
-Befehl übergeben. Die Ausgabe von Get-PSBreakPoint
wird an übergeben, um Disable-PSBreakpoint
den Haltepunkt im Runspace zu deaktivieren.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace
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 weiterleiten.
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 |
-Runspace
Gibt die ID eines Runspace-Objekts an, damit Sie mit Haltepunkten im angegebenen Runspace interagieren können.
Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.
Type: | Runspace |
Aliases: | RunspaceId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 Haltepunktobjekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein Haltepunktobjekt zurück, das den deaktivierten Haltepunkt darstellt.
Hinweise
PowerShell enthält die folgenden Aliase für Disable-PSBreakpoint
:
- Alle Plattformen:
dbp