Debug-Runspace

Debug-Runspace
    [-Runspace] <Runspace>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace
    [-Name] <String>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace
    [-Id] <Int32>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace
    [-InstanceId] <Guid>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace cmdlet 启动与本地或远程活动运行环境的交互式调试会话。 可以先运行 Get-Process 来查找与 PowerShell 关联的进程，然后使用 Enter-PSHostProcess 和 Id 参数中指定的进程 ID 来附加到该进程，然后使用 Get-Runspace 列出 PowerShell 主机进程中的运行空间，从而找到要调试的运行空间。

选择要调试的运行空间后，如果运行空间当前正在运行命令或脚本，或者脚本已在断点处停止，PowerShell 将为运行空间打开远程调试器会话。 可以采用远程会话脚本的调试方式调试运行空间脚本。

如果你是运行进程的计算机上的管理员，或者你在运行要调试的脚本，则只能附加到 PowerShell 主机进程。 此外，不能输入正在运行当前 PowerShell 会话的主机进程。 只能输入运行其他 PowerShell 会话的主机进程。

在此示例中，你将调试在远程计算机 WS10TestServer 上打开的运行空间。 在命令的第一行中，在远程计算机上运行 Get-Process，并筛选 Windows PowerShell 主机进程。 在此示例中，需要调试进程 ID 1152（Windows PowerShell ISE 主机进程）。

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

在第二个命令中，运行 Enter-PSSession 在 WS10TestServer 上打开远程会话。 在第三个命令中，你通过运行 Enter-PSHostProcess来附加到远程服务器上正在运行的 Windows PowerShell ISE 主机进程，并指定在第一个命令中获得的主机进程 ID 1152。

在第四个命令中，通过运行 Get-Runspace列出进程 ID 1152 的可用运行空间。 请注意忙碌运行空间的 ID 编号，它正在运行你要调试的脚本。

在最后一个命令中，你通过运行 TestWFVar1.ps1来开始调试正在运行脚本 Debug-Runspace的已打开运行空间，并通过添加 Id 参数，以 ID 2 来标识运行空间。 由于脚本中有断点，调试器会打开。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将 Get-Runspace 命令的结果传递给此 cmdlet。

Debug-Runspace 适用于处于打开状态的运行空间。 如果运行空间状态从“打开”更改为另一个状态，该运行空间将自动从正在运行的列表中删除。 仅当运行空间满足以下条件时，它才会被添加到正在运行的列表中。

• 如果它来自 Invoke-Command，也就是说，它具有 Invoke-Command GUID ID。
• 如果它来自 Debug-Runspace，也就是说，它具有 Debug-Runspace GUID ID。
• 如果它来自 PowerShell 工作流，并且其工作流作业 ID 与当前活动调试器工作流作业 ID 相同。