安装 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
-
有关重新注册所有管理单元的说明,请参阅这篇文章。