安装 App Layering 代理
App Layering 代理使设备或打包机能够在本地运行 PowerShell 命令。如果您提供了正确的凭据，则代理可以作为特定用户运行 PowerShell 命令。
需要代理时
如果您计划执行以下操作，则需要使用 App Layering 代理：
- 使用连接器配置启动脚本。
- 在微软 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 代理，则可以从 Citrix 下载页面下载更新的版本。代理安装软件包包含在 App Layering ZIP 下载中。
下载 App Layering 代理
- 转到 Citrix 主页，然后单击登录。
- 单击下载，然后从列表中选择 Citrix App Layering。
- 在 Citrix App Layering 页面上的 Citrix App Layering > 产品软件下，单击 Citrix App Layering。
- 在页面底部，单击工具。
- 单击 Citrix App Layering 代理下载文件。 文件 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 设备注册中所述的步骤手动注册。
-
单击完成退出向导。
手动向设备注册 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 服务器上加载相应的 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 和代理管理单元未注册（例如，在重大 Windows 更新之后），请找出哪些管理单元。
-
-
运行以下命令以列出已注册的管理单元：
get-pssnapin -registered -
有关重新注册所有管理单元的说明，请参阅这篇文章。