Disable-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Deaktiviert die Haltepunkte in der aktuellen Konsole.

Syntax

Breakpoint (Standard) 

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

Id 

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

Beschreibung

Das Disable-PSBreakpoint Cmdlet 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 Enable-PSBreakpoint Cmdlet, um einen Haltepunkt erneut zu aktivieren. Haltepunkte sind standardmäßig aktiviert, wenn Sie sie mit dem Set-PSBreakpoint Cmdlet 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 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 lautet der Wert der Enabled-Eigenschaft des Haltepunktobjekts "$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 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 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 wird, 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

Beispiel 5: Deaktivieren eines Haltepunkts in einem Runspace

In diesem Beispiel wird ein Auftrag gestartet, und ein Haltepunkt wird festgelegt, wenn der Set-PSBreakpoint Vorgang ausgeführt wird. Der Runspace wird in einer Variablen gespeichert und mit dem parameter Get-PSBreakpoint an den befehl übergeben. Die Ausgabe wird Get-PSBreakpoint weitergeleitet, um den Haltepunkt im Runspace zu Disable-PSBreakpoint 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 Haltepunktobjekte an das Disable-PSBreakpoint Cmdlet weiterleiten.

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:Cf

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

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 die aktivierten Haltepunkte darstellt. 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

-Runspace

Gibt die ID eines Runspace- -Objekts an, sodass Sie mit Haltepunkten im angegebenen Runspace interagieren können.

Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.

Parametereigenschaften

Typ:Runspace
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:RunspaceId

Parametersätze

Id
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
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 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

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

  • Alle Plattformen:
    • dbp