Debug-Runspace
使用运行空间启动交互式调试会话。
语法
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>]
说明
cmdlet Debug-Runspace
使用本地或远程活动运行空间启动交互式调试会话。 可以查找要调试的运行空间,方法是先运行 Get-Process
以查找与 PowerShell 关联的进程,然后使用 Enter-PSHostProcess
Id 参数中指定的进程 ID 附加到进程,然后 Get-Runspace
列出 PowerShell 主机进程中的运行空间。
选择要调试的运行空间后,如果运行空间当前正在运行命令或脚本,或者脚本已在断点处停止,PowerShell 将打开运行空间的远程调试器会话。 可以采用与调试远程会话脚本相同的方式调试运行空间脚本。
如果你是运行该进程的计算机上的管理员,或者正在运行要调试的脚本,则只能附加到 PowerShell 主机进程。 此外,不能进入运行当前 PowerShell 会话的主机进程。 只能输入运行不同 PowerShell 会话的主机进程。
示例
示例 1:调试远程运行空间
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
PS C:\> [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:\> >
在此示例中,调试在远程计算机 WS10TestServer 上打开的运行空间。 在命令的第一行中,在远程计算机上运行Get-Process
,并筛选Windows PowerShell主机进程。 在此示例中,你想要调试进程 ID 1152(Windows PowerShell ISE 主机进程)。
在第二个命令中,运行 Enter-PSSession
以在 WS10TestServer 上打开远程会话。 在第三个命令中,通过运行 Enter-PSHostProcess
并指定在第一个命令 1152 中获取的主机进程的 ID,附加到远程服务器上运行的 Windows PowerShell ISE 主机进程。
在第四个命令中,通过运行 Get-Runspace
列出进程 ID 1152 的可用运行空间。
记下忙碌运行空间的 ID 号;它正在运行要调试的脚本。
在最后一个命令中,开始调试正在运行脚本的已打开的运行空间,TestWFVar1.ps1,通过运行 Debug-Runspace
,并通过添加 Id 参数通过 ID 标识运行空间。 由于脚本中有断点,因此调试器将打开。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定运行空间的 ID 号。 可以运行 Get-Runspace
来显示运行空间 ID。
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
按实例 ID 指定运行空间,这是一个可以通过运行 Get-Runspace
显示的 GUID。
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
按名称指定运行空间。 可以运行 Get-Runspace
来显示运行空间的名称。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Runspace
指定 runspace 对象。 为此参数提供值的最简单方法是指定包含已 Get-Runspace
筛选命令结果的变量。
Type: | Runspace |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将命令的结果 Get-Runspace
传递给 Debug-Runspace。
备注
Debug-Runspace
适用于处于“已打开”状态的运行空间。 如果运行空间状态从“已打开”更改为另一种状态,则会自动从运行列表中删除该运行空间。 仅当运行空间满足以下条件时,才会将其添加到运行列表中。
- 如果它来自 Invoke-Command;也就是说,它具有
Invoke-Command
GUID ID。 - 如果它来自
Debug-Runspace
,则具有Debug-Runspace
GUID ID。 - 如果它来自 PowerShell 工作流,并且其工作流作业 ID 与当前活动调试器工作流作业 ID 相同。