Enter-PSHostProcess

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 cmdlet 连接到本地进程并进入交互式会话。

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

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

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

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

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

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

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

PS C:\> Enter-PSHostProcess -Name powershell_ise
[Process:1520]: PS C:\Test\Documents>

Next, get available runspaces within the process you have entered.
PS C:\> [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

# The runspace objects returned by **Get-Runspace** also have a NoteProperty
# called **ScriptStackTrace** of the running command stack, if available.Next,
# debug runspace ID 4, that is running another user's long-running script. From
# the list returned from **Get-Runspace**, note that the runspace state is
# **Opened**, and **Availability** is **Busy**, meaning that the runspace is
# still running the long-running script.

PS C:\> [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>

# Start an interactive debugging session with this runspace by running the
# Debug-Runspace cmdlet.

PS C:\> [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:\> >

# After you are finished debugging, allow the script to continue running without
# the debugger attached by running the **exit** debugger command. Alternatively,
# you can quit the debugger with the **q** or **Stop** commands.

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

# When you are finished working in the process, exit the process by running the
# Exit-PSHostProcess cmdlet. This returns you to the PS C:\> prompt.

PS C:\> [Process:1520]: PS C:\>  Exit-PSHostProcess
PS C:\>

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

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

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

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