安装 App Layering 代理

Last published : Oct 24, 2026
App Layering 代理使设备或打包机能够在本地运行 PowerShell 命令。如果您提供正确的凭据，代理可以作为特定用户运行 PowerShell 命令。

何时需要代理

如果您计划执行以下操作，则需要 App Layering 代理：
  • 使用连接器配置启动脚本。
  • 在 Microsoft Hyper-V 中运行 App Layering 设备。
  • 将分层映像发布到 Citrix Provisioning。
您可以在以下位置安装代理：
  • 在您计划用于层创建或映像发布的所有 Hyper-V 服务器上。
  • 在您计划发布分层映像的任何 Citrix Provisioning 服务器上。
  • 在您的连接器配置运行 PowerShell 脚本的位置。

将代理注册到设备

App Layering 代理安装程序会提示您将代理注册到 App Layering 设备。如果您在安装过程中未注册代理，您可以稍后手动注册它。但是，在代理注册到设备之前，PowerShell 脚本不会运行。

先决条件

在安装 App Layering 代理之前，请确保您安装代理的系统满足以下要求：
  • 具有管理员权限的帐户
  • .NET 4.5
  • PowerShell 3.0 或更高版本
  • PowerShell Snap-in。在 Citrix Provisioning Services 服务器上使用 App Layering 代理之前，您必须确保已安装 PowerShell Snap-in。请参阅将代理(/zh-cn/citrix-app-layering/4/install-agent.html#manually-register-the-app-layering-agent-with-the-appliance)手动注册到设备中的步骤。
如果您之前安装了 App Layering 代理，可以从 Citrix® 下载页面下载更新版本。代理安装包包含在 App Layering ZIP 下载中。

下载 App Layering 代理

  1. 转到 Citrix 主页，然后单击“登录”。
  2. 单击“下载”，并从列表中选择“Citrix App Layering™”。
  3. 在 Citrix App Layering 页面上，在“Citrix App Layering > 产品软件”下，单击“Citrix App Layering”。
  4. 在页面底部，单击“工具”。
  5. 单击 Citrix App Layering 代理“下载文件”。 文件 citrix_app_layering_agent_installer.exe 将下载到您的计算机。

安装 App Layering 代理

App Layering 代理安装程序会提示您将代理注册到 App Layering 设备。如果您在安装过程中未注册代理，则可以稍后手动注册。但是，请记住，代理必须先注册到设备，然后 PowerShell 脚本才能运行。
  1. 使用具有管理员权限的帐户登录到要安装代理的系统。
  2. 将 Citrix_app_layering_agent_installer.exe 文件复制到服务器上的一个方便位置。
  3. 以管理员身份运行 Citrix_app_layering_agent_installer.exe，并在出现提示时，输入要安装 App Layering 代理的目录路径。默认位置是 C:\\Program Files (x86)\Citrix\Agent。
    代理安装程序会检查所有先决条件是否都已具备。如果缺少任何先决条件，安装程序将报告此情况并退出，而不进行安装。
  4. 安装程序会提示您输入代理端口号。您可以接受默认端口号 (8016)，如果默认端口已被占用，也可以指定其他端口号。
  5. 安装程序会提示您输入 App Layering 设备的凭据（地址、用户名和密码）。通过输入具有管理员权限的设备上管理控制台用户的 IP 地址和登录凭据（例如，您用于登录管理控制台的凭据），将 App Layering 代理注册到设备。
    注意：
    如果 App Layering 设备不可用，或者您选择现在不注册，则可以稍后使用“手动注册 App Layering 设备”中描述的步骤手动注册。
  6. 单击“完成”退出向导。

手动将 App Layering 代理注册到设备

将 App Layering 代理注册到设备。
如果在安装过程中未将 App Layering 代理注册到 App Layering 设备，则可以稍后使用以下过程进行注册。
  1. 以管理员身份登录到安装了 App Layering 代理的服务器。
  2. 以管理员身份打开命令窗口 (cmd.exe)，然后导航到安装 App Layering 代理的目录。默认位置是 C:\\Program Files (x86)\Citrix\Agent。
  3. 运行以下 PowerShell 命令：
    Enable-PSRemoting
  4. 通过运行此命令验证端口 8016 是否已打开：
    netstat -a
  5. 以管理员身份打开命令窗口 (cmd.exe)，并导航到 App Layering Agent 的安装目录。默认位置为：
    C:\Program Files (x86)\Citrix\Agent
  6. 运行以下命令，在指示位置使用设备的 IP 地址：
    Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator
  7. 出现提示时，输入在设备管理控制台中具有管理员权限的用户的密码。
  8. 注册过程完成后，将显示一条消息，通知您注册成功。App Layering 代理注册将显示在管理服务的审核日志中。
    如果该过程不成功，请检查安装目录中的代理日志文件：
    C:\\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
    您还可以通过运行以下命令查看 App Layering 代理命令行选项的帮助：
    Citrix.AppLayering.Agent.Service.exe /??
  9. 运行 PowerShell 命令以在 Citrix Provisioning Server 上加载相应的 DLL 文件。
    对于 PVS 7.7 及更高版本：
    1. 导航到：
      C:\program files\citrix\provisioning services console
    2. 运行命令：
      C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll
    对于 PVS 7.1–7.6：
    1. 导航到：
      C:\program files\citrix\provisioning services console
    2. 运行命令：
      C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll
    如果某些 Citrix Provisioning 和 Broker 管理单元未注册（例如在 Windows 大版本更新后），请找出是哪些管理单元。
  10. 运行以下命令以列出已注册的管理单元：
    get-pssnapin -registered
  11. 有关重新注册所有管理单元的说明，请参阅此文章。