登录  |  注册
当前位置：网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 输入 PSHostProcess (Microsoft.PowerShell.Core)

作者：精品下载站 日期：2024-12-14 02:16:30 浏览：12 分类：玩电脑

输入 PSHostProcess (Microsoft.PowerShell.Core)

输入-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 的现有进程中运行。当您与指定进程上的远程会话交互时，您可以枚举正在运行的运行空间，然后通过运行 Debug-Runspace 或 Enable-RunspaceDebug 选择要调试的运行空间。

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

选择要调试的运行空间后，如果运行空间当前正在运行命令或在调试器中停止，则会为该运行空间打开远程调试会话。然后，您可以像调试其他远程会话脚本一样调试运行空间脚本。

通过运行 exit 两次，从调试会话中分离，然后与进程的交互会话分离，或者通过运行现有调试器 quit 命令来停止脚本执行。

如果使用 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 返回的列表中，请注意运行空间 State 为 Opened，Availability 为 Busy，这意味着运行空间仍在运行长时间运行的脚本。 Get-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 部分：完成调试会话并退出

完成调试后，通过运行 exit debugger 命令允许脚本在不附加调试器的情况下继续运行。或者，您可以使用 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

位置：

1

默认值：

默认应用程序域

必需的：

False

接受管道输入：

False

接受通配符：

False

-CustomPipeName

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

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

类型 ：

String

位置：

命名

默认值：

None

必需的：

True

接受管道输入：

False

接受通配符：

False

-HostProcessInfo

指定可以使用 PowerShell 连接的 PSHostProcessInfo 对象。使用 Get-PSHostProcessInfo 获取该对象。

类型 ：

PS主机进程信息

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-Id

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

类型 ：

整数32

位置：

0

默认值：

None

必需的：

True

接受管道输入：

False

接受通配符：

False

-Name

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

类型 ：

String

位置：

0

默认值：

None

必需的：

True

接受管道输入：

False

接受通配符：

False

-Process

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

类型 ：

过程

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

输入

流程

笔记

Enter-PSHostProcess 无法进入您正在其中运行命令的 PowerShell 会话的进程。不过，您可以输入另一个 PowerShell 会话的进程，或者与您运行 Enter-PSHostProcess 的会话同时运行的 PowerShell ISE 会话。

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

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

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

猜你还喜欢

您需要 登录账户 后才能发表评论

取消回复欢迎 你 发表评论:

精品推荐！
欢迎 访客 登录没有账号？
  • 最新文章
  • 热门文章
  • 热评文章
最新评论
    热门tag
    友情链接

    关灯