安装 App Layering 代理
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 管理单元。在 Citrix Provisioning Services 服务器上使用 App Layering 代理之前，您必须确保已安装 PowerShell 管理单元。请参阅手动将 App Layering 代理注册到设备的步骤。
如果您之前安装过 App Layering 代理，可以从 Citrix® 下载页面下载更新版本。代理安装包包含在 App Layering ZIP 下载中。
下载 App Layering 代理
- 转至 Citrix 主页，然后单击 Sign in（登录）。
- 单击 Downloads（下载），然后从列表中选择 Citrix App Layering™。
- 在 Citrix App Layering 页面上，在 Citrix App Layering > Product Software（Citrix App Layering > 产品软件）下，单击 Citrix App Layering。
- 在页面底部，单击 Tools（工具）。
- 单击 Citrix App Layering 代理 Download File（下载文件）。 文件 citrix_app_layering_agent_installer.exe 将下载到您的计算机。
安装 App Layering 代理
App Layering 代理安装程序会提示您将代理注册到 App Layering 设备。如果您在安装期间未注册代理，则可以稍后手动注册。但是，请记住，代理必须在 PowerShell 脚本运行之前注册到设备。
-
使用具有管理员权限的帐户登录到要安装代理的系统。
-
将文件 Citrix_app_layering_agent_installer.exe 复制到服务器上的一个方便位置。
-
以管理员身份运行 Citrix_app_layering_agent_installer.exe，并在出现提示时，输入要安装 App Layering 代理的目录路径。默认位置为 C:\Program Files (x86)\Citrix\Agent。
代理安装程序会检查所有先决条件是否存在。如果缺少任何先决条件，安装程序将报告此情况并退出而不进行安装。
-
安装程序会提示您输入代理端口号。您可以接受默认端口号 (8016)，如果默认端口已被占用，也可以指定其他端口号。
-
安装程序会提示您输入 App Layering 设备的凭据（地址、用户名和密码）。通过输入设备的 IP 地址以及具有管理员权限的管理控制台用户的登录凭据（例如，您用于登录管理控制台的凭据）来将 App Layering 代理注册到设备。
注意：
如果 App Layering 设备不可用，或者您选择现在不注册，则可以稍后使用“手动注册 App Layering 设备”中描述的步骤手动注册。
-
单击 Finish（完成）退出向导。
手动将 App Layering 代理注册到设备
将 App Layering 代理注册到设备。
如果在安装期间未将 App Layering 代理注册到 App Layering 设备，则可以稍后使用以下步骤进行注册。
-
以管理员身份登录到安装了 App Layering 代理的服务器。
-
以管理员身份打开命令窗口 (cmd.exe)，然后导航到安装 App Layering 代理的目录。默认位置为：C:\Program Files (x86)\Citrix\Agent。
-
运行以下 PowerShell 命令：
Enable-PSRemoting -
通过运行此命令验证端口 8016 是否已打开：
netstat -a -
以管理员身份打开命令窗口 (cmd.exe)，然后导航到安装 App Layering 代理的目录。默认位置为：
C:\Program Files (x86)\Citrix\Agent -
运行以下命令，在指示位置使用设备的 IP 地址：
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
出现提示时，输入在设备管理控制台中具有管理员权限的用户的密码。
-
注册过程完成后，将显示一条消息，通知您成功。App Layering 代理注册将显示在管理服务的审核日志中。
如果过程不成功，请检查安装目录中的代理日志文件：
C:\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
您还可以通过运行以下命令查看 App Layering 代理命令行选项的帮助：
Citrix.AppLayering.Agent.Service.exe /? -
运行 PowerShell 命令以在 Citrix Provisioning Server 上加载相应的 DLL 文件。
对于 PVS 7.7 及更高版本：
-
导航到：
C:\program files\citrix\provisioning services console -
运行命令：
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll
对于 PVS 7.1–7.6：
-
导航到：
C:\program files\citrix\provisioning services console -
运行命令：
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll
如果某些 Citrix Provisioning 和 Broker 管理单元未注册，例如在 Windows 大版本更新之后，请找出是哪些。
-
-
运行以下命令列出已注册的管理单元：
get-pssnapin -registered -
请参阅此文章以获取重新注册所有管理单元的说明。