Debug-Runspace
使用 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>]
说明
cmdlet Debug-Runspace
使用本地或远程活动运行空间启动交互式调试会话。 可以通过运行来查找要调试的运行空间,方法是先运行 Get-Process
以查找与 PowerShell 关联的进程,然后使用 Enter-PSHostProcess
Id 参数中指定的进程 ID 来附加到进程,然后 Get-Runspace
列出 PowerShell 主机进程中的运行空间。
选择要调试的运行空间后,如果 runspace 当前正在运行命令或脚本,或者脚本已在断点处停止,PowerShell 会为 runspace 打开远程调试器会话。 可以采用与远程会话脚本调试相同的方式调试 runspace 脚本。
只有你是运行该进程的计算机上的管理员,或者正在运行要调试的脚本时,才能附加到 PowerShell 主机进程。 此外,不能输入运行当前 PowerShell 会话的主机进程。 只能输入运行不同 PowerShell 会话的主机进程。
示例
示例 1:调试远程运行空间
在此示例中,将调试在远程计算机 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
并指定在第一个命令 1152 中获取的主机进程的 ID,将附加到远程服务器上运行的 Windows PowerShell ISE 主机进程。
在第四个命令中,通过运行 Get-Runspace
列出进程 ID 1152 的可用运行空间。
记下忙碌运行空间的 ID 号;它正在运行要调试的脚本。
在最后一个命令中,通过运行 Debug-Runspace
、开始调试正在运行脚本TestWFVar1.ps1
的已打开的 runspace,并通过添加 Id 参数按其 ID 标识 runspace。 由于脚本中有断点,因此将打开调试器。
参数
-BreakAll
允许在调试器附加时立即中断当前位置。
参数仅可用作实验性功能。 有关详细信息,请参阅 使用实验性功能。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
来显示 runspace ID。
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
按运行空间的实例 ID 指定运行空间,该实例 ID 是一个可以通过运行 Get-Runspace
显示的 GUID。
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
按其名称指定 runspace。 可以运行 Get-Runspace
来显示 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
适用于处于“已打开”状态的运行空间。 如果运行空间状态从“已打开”更改为另一种状态,则会自动从运行列表中删除该 runspace。 仅当运行空间满足以下条件时,才会将其添加到运行列表中。
- 如果它来自 Invoke-Command;也就是说,它具有
Invoke-Command
GUID ID。 - 如果它来自
Debug-Runspace
;也就是说,它具有Debug-Runspace
GUID ID。 - 如果它来自 PowerShell 工作流,并且其工作流作业 ID 与当前活动调试器工作流作业 ID 相同。