Enter-PSHostProcess

参考

模块:: Microsoft.PowerShell.Core

使用本地进程连接到交互式会话并进入交互式会话。

语法

Enter-PSHostProcess
     [-Id] <Int32>
     [[-AppDomainName] <String>]
     [<CommonParameters>]

Enter-PSHostProcess
     [-Process] <Process>
     [[-AppDomainName] <String>]
     [<CommonParameters>]

Enter-PSHostProcess
     [-Name] <String>
     [[-AppDomainName] <String>]
     [<CommonParameters>]

Enter-PSHostProcess
     [-HostProcessInfo] <PSHostProcessInfo>
     [[-AppDomainName] <String>]
     [<CommonParameters>]

Enter-PSHostProcess
     -CustomPipeName <String>
     [<CommonParameters>]

说明

Enter-PSHostProcess cmdlet 连接到本地进程并进入交互式会话。从 PowerShell 6.2 开始，非 Windows 平台上支持此 cmdlet。

远程交互式会话在已运行 PowerShell 的现有进程中运行，而不是创建新的进程来托管 PowerShell 并运行远程会话。在指定进程中与远程会话交互时，可以枚举正在运行的 runspaces，然后通过运行 Debug-Runspace 或 Enable-RunspaceDebug选择要调试的运行空间。

要输入的进程必须托管 PowerShell（System.Management.Automation.dll）。必须是找到进程的计算机上的 Administrators 组的成员，或者必须是运行启动进程的脚本的用户。

选择要调试的运行空间后，如果运行当前正在运行命令或在调试器中停止，则会为运行空间打开远程调试会话。然后，可以采用与调试其他远程会话脚本相同的方式调试 Runspace 脚本。

从调试会话中分离，然后使用进程交互会话运行两次退出，或者通过运行现有调试器退出命令停止脚本执行。

如果使用 Name 参数指定进程，并且只有一个进程找到具有指定名称的进程，则输入进程。如果找到具有指定名称的多个进程，PowerShell 将返回错误，并列出使用指定名称找到的所有进程。

为了支持附加到远程计算机上的进程，Enter-PSHostProcess cmdlet 在指定的远程计算机上启用，以便你可以附加到远程 PowerShell 会话中的本地进程。

示例

示例第 1 部分：开始在 PowerShell ISE 进程中调试运行空间

在此示例中，从 PowerShell 控制台中运行 Enter-PSHostProcess 以输入 PowerShell ISE 进程。在生成的交互式会话中，可以通过运行 Get-Runspace找到要调试的运行空间，然后调试运行空间。

PS C:\> Enter-PSHostProcess -Name powershell_ise
[Process:1520]: PS C:\>  Get-Runspace
Id    Name          InstanceId                               State           Availability
--    -------       -----------                              ------          -------------
1     Runspace1     2d91211d-9cce-42f0-ab0e-71ac258b32b5     Opened          Available
2     Runspace2     a3855043-cb16-424a-a616-685360c3763b     Opened          RemoteDebug
3     MyLocalRS     2236dbd8-2105-4dec-a15a-a27d0bfaacb5     Opened          LocalDebug
4     MyRunspace    771356e9-8c44-4b70-9de5-dd17cb41e48e     Opened          Busy
5     Runspace8     3e517382-a97a-49ba-9c3c-fd21f6664288     Broken          None

示例第 2 部分：调试特定的运行空间

接下来，调试运行空间 ID 4，即运行其他用户的长时间运行的脚本。从从 Get-Runspace返回的列表中，请注意，运行空间状态已打开，可用性 为“忙碌”，这意味着运行空间仍在运行长时间运行的脚本。 Get-Runspace 返回的 runspace 对象还具有名为 ScriptStackTrace 的 NoteProperty（如果可用）。

[Process:1520]: PS C:\>  (Get-Runspace -Id 4).ScriptStackTrace
Command                    Arguments                           Location
-------                    ---------                           --------
MyModuleWorkflowF1         {}                                  TestNoFile3.psm1: line 6
WFTest1                    {}                                  TestNoFile2.ps1: line 14
TestNoFile2.ps1            {}                                  TestNoFile2.ps1: line 22
<ScriptBlock>              {}                                  <No file>

[Process: 1520]: PS C:\>  Debug-Runspace -Id 4
Hit Line breakpoint on 'C:\TestWFVar1.ps1:83'

At C:\TestWFVar1.ps1:83 char:1
+ $scriptVar = "Script Variable"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[Process: 1520]: [RSDBG: 4]: PS C:\>

通过运行 Debug-Runspace cmdlet 来启动使用此运行空间的交互式调试会话。

示例第 3 部分：完成调试会话并退出

完成调试后，通过运行退出调试器命令，允许脚本继续运行，而无需附加调试器。或者，可以使用 q 或 Stop 命令退出调试器。

完成处理后，通过运行 Exit-PSHostProcess cmdlet 退出进程。这会返回到 PS C:\> 提示符。

[Process:346]: [RSDBG: 3]: PS C:\> exit
[Process:1520]: PS C:\>
[Process:1520]: PS C:\>  Exit-PSHostProcess
PS C:\>

参数

-AppDomainName

指定要连接到的应用程序域名（如果省略），请使用 DefaultAppDomain。使用 Get-PSHostProcessInfo 显示应用程序域名。

类型:	String
Position:	1
默认值:	DefaultAppDomain
必需:	False
接受管道输入:	False
接受通配符:	False

-CustomPipeName

获取或设置要连接到的自定义命名管道名称。这通常与 pwsh -CustomPipeName结合使用。

此参数是在 PowerShell 6.2 中引入的。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-HostProcessInfo

指定一个 PSHostProcessInfo 对象，该对象可以使用 PowerShell 连接到该对象。使用 Get-PSHostProcessInfo 获取对象。

类型:	PSHostProcessInfo
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Id

按进程 ID 指定进程。若要获取进程 ID，请运行 Get-Process cmdlet。

类型:	Int32
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

按进程名称指定进程。若要获取进程名称，请运行 Get-Process cmdlet。还可以从任务管理器中进程的“属性”对话框获取进程名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Process

按进程对象指定进程。使用此参数的最简单方法是保存 Get-Process 命令的结果，该命令返回要在变量中输入的进程，然后将变量指定为此参数的值。

类型:	Process
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

Process

备注

Enter-PSHostProcess 无法输入运行命令的 PowerShell 会话的过程。但是，可以输入另一个 PowerShell 会话的过程，或与运行 Enter-PSHostProcess的会话同时运行的 PowerShell ISE 会话。

Enter-PSHostProcess 只能输入托管 PowerShell 的进程。也就是说，它们已加载 PowerShell 引擎。

若要从进程内退出进程，请键入退出，然后按 Enter。

在 PowerShell 7.1 之前，通过 SSH 进行远程处理不支持第二跃点远程会话。此功能仅限于使用 WinRM 的会话。 PowerShell 7.1 允许 Enter-PSSession 和 Enter-PSHostProcess 在任何交互式远程会话中工作。

通过