Freigeben über

Debug-Runspace

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Startet eine interaktive Debugsitzung mit einem Runspace.

Syntax

Debug-Runspace
     [-Runspace] <Runspace>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Runspace
     [-Name] <String>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Runspace
     [-Id] <Int32>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Runspace
     [-InstanceId] <Guid>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet Debug-Runspace startet eine interaktive Debugsitzung mit einem lokalen oder remoteaktiven Runspace. Sie finden einen Runspace, den Sie debuggen möchten, indem Sie zuerst Get-Process ausführen, um Prozesse zu finden, die mit PowerShell verknüpft sind, und dann Enter-PSHostProcess mit der prozess-ID, die im -ID- Parameter angegeben ist, an den Prozess anzufügen, und dann Get-Runspace, um Runspaces innerhalb des PowerShell-Hostprozesses auflisten.

Nachdem Sie einen zu debuggenden Runspace ausgewählt haben, wenn der Runspace zurzeit einen Befehl oder ein Skript ausführt oder das Skript an einem Haltepunkt beendet wurde, öffnet PowerShell eine Remotedebuggersitzung für den Runspace. Sie können das Runspace-Skript auf die gleiche Weise debuggen, wie Remotesitzungsskripts gedebuggt werden.

Sie können nur an einen PowerShell-Hostprozess anfügen, wenn Sie ein Administrator auf dem Computer sind, auf dem der Prozess ausgeführt wird, oder sie führen das Skript aus, das Sie debuggen möchten. Außerdem können Sie den Hostprozess nicht eingeben, der die aktuelle PowerShell-Sitzung ausführt. Sie können nur einen Hostprozess eingeben, der eine andere PowerShell-Sitzung ausführt.

Beispiele

Beispiel 1: Debuggen eines Remote-Runspaces

In diesem Beispiel debuggen Sie einen Runspace, der auf einem Remotecomputer geöffnet ist, WS10TestServer. In der ersten Zeile des Befehls führen Sie Get-Process auf dem Remotecomputer aus, und filtern Sie nach Windows PowerShell-Hostprozessen. In diesem Beispiel möchten Sie die Prozess-ID 1152, den Windows PowerShell ISE-Hostprozess, debuggen.

PS C:\> Get-Process -ComputerName "WS10TestServer" -Name "*powershell*"

Handles      WS(K)   VM(M)      CPU(s)    Id  ProcessName
-------      -----   -----      ------    --  -----------
    377      69912     63     2.09      2420  powershell
    399     123396    829     4.48      1152  powershell_ise

PS C:\> Enter-PSSession -ComputerName "WS10TestServer"
[WS10TestServer]:PS C:\> Enter-PSHostProcess -Id 1152
[WS10TestServer:][Process:1152]: PS C:\Users\Test\Documents> Get-Runspace

Id Name            ComputerName    Type          State         Availability
-- ----            ------------    ----          -----         ------------
 1 Runspace1       WS10TestServer  Remote        Opened        Available
 2 RemoteHost      WS10TestServer  Remote        Opened        Busy

[WS10TestServer][Process:1152]: PS C:\Users\Test\Documents> Debug-Runspace -Id 2

Hit Line breakpoint on 'C:\TestWFVar1.ps1:83'
At C:\TestWFVar1.ps1:83 char:1
+ $scriptVar = "Script Variable"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[Process:1152]: [RSDBG: 2]: PS C:\> >

Im zweiten Befehl führen Sie Enter-PSSession aus, um eine Remotesitzung auf WS10TestServer zu öffnen. Im dritten Befehl fügen Sie den Windows PowerShell ISE-Hostprozess an, der auf dem Remoteserver ausgeführt wird, indem Sie Enter-PSHostProcessausführen und die ID des Hostprozesses angeben, den Sie im ersten Befehl abgerufen haben, 1152.

Im vierten Befehl listen Sie verfügbare Runspaces für die Prozess-ID 1152 auf, indem Sie Get-Runspaceausführen. Sie notieren die ID-Nummer des Beschäftigt-Runspaces; es wird ein Skript ausgeführt, das Sie debuggen möchten.

Im letzten Befehl beginnen Sie mit dem Debuggen eines geöffneten Runspaces, das ein Skript ausführt, TestWFVar1.ps1, indem Sie Debug-Runspaceausführen und den Runspace anhand der ID 2 identifizieren, indem Sie den parameter ID hinzufügen. Da im Skript ein Haltepunkt vorhanden ist, wird der Debugger geöffnet.

Parameter

-Confirm

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

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

-Id

Gibt die ID-Nummer eines Runspaces an. Sie können Get-Runspace ausführen, um Runspace-IDs anzuzeigen.

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

-InstanceId

Gibt einen Runspace anhand der Instanz-ID an, eine GUID, die Sie anzeigen können, indem Sie Get-Runspaceausführen.

Typ:Guid
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Runspace anhand seines Namens an. Sie können Get-Runspace ausführen, um die Namen von Runspaces anzuzeigen.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Runspace

Gibt ein Runspace-Objekt an. Die einfachste Möglichkeit, einen Wert für diesen Parameter bereitzustellen, besteht darin, eine Variable anzugeben, die die Ergebnisse eines gefilterten Get-Runspace Befehls enthält.

Typ:Runspace
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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:True
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Runspace

Sie können die Ergebnisse eines Get-Runspace Befehls an dieses Cmdlet weiterleiten.

Hinweise

Debug-Runspace funktioniert bei Runspaces, die sich im Zustand "Geöffnet" befinden. Wenn sich ein Runspace-Zustand von "Geöffnet" in einen anderen Zustand ändert, wird dieser Runspace automatisch aus der laufenden Liste entfernt. Der laufenden Liste wird nur ein Runspace hinzugefügt, wenn er die folgenden Kriterien erfüllt.

  • Wenn er von Invoke-Command stammt; das heißt, es verfügt über eine Invoke-Command GUID-ID.
  • Wenn es von Debug-Runspacekommt ; das heißt, es verfügt über eine Debug-Runspace GUID-ID.
  • Wenn er von einem PowerShell-Workflow stammt und seine Workflowauftrags-ID mit der aktuellen aktiven Debugger-Workflowauftrags-ID identisch ist.