使用命令行安装 VDA
简介
本文适用于在使用 Windows 操作系统的计算机上安装、升级和自定义 Virtual Delivery Agent (VDA)。
本文介绍如何发出 VDA 安装命令。开始安装之前,请查看安装 VDA 以了解与安装注意事项、安装程序以及您在安装过程中指定的内容有关的信息。
从命令行安装 VDA
要安装 VDA(并查看命令执行进度和返回值),必须具有更高的管理权限或使用以管理员身份运行。
- 在要安装 VDA 的计算机上,登录 Citrix Cloud。
- 在左上角的菜单中,选择我的服务 > DaaS。
- 在右上角,单击 Downloads(下载)并选择 Download VDA(下载 VDA)。您被重定向到 VDA 下载页面。找到所需的 VDA 安装程序,然后单击“下载文件”。
-
下载完成后,运行其名称。请使用本文中介绍的选项。
-
对于多会话操作系统 Virtual Delivery Agent,请运行
VDAServerSetup.exe
-
对于单会话操作系统 Virtual Delivery Agent,请运行
VDAWorkstationSetup.exe
-
对于单会话操作系统核心服务 Virtual Delivery Agent,请运行
VDAWorkstationCoreSetup.exe
-
要在安装之前提取文件,请使用 /extract
和绝对路径,例如 .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia
。(该目录必须存在。否则,提取将失败。)然后在单独的命令中,使用本文中列出的有效选项运行相应的命令。
-
对于
VDAServerSetup_XXXX.exe
,请运行<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
-
对于
VDAWorkstationCoreSetup_XXXX.exe
,请运行<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe
-
对于
VDAWorkstationSetup_XXXX.exe
,请运行<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
用于安装 VDA 的命令行选项
以下选项在一个或多个命令中有效:VDAServerSetup.exe
、VDAWorkstationSetup.exe
和 VDAWorkstationCoreSetup.exe
。
-
/components component[,component]
要安装或删除的组件的列表(以逗号分隔)。有效值为:
-
VDA: Virtual Delivery Agent
-
插件: 适用于 Windows 的 Citrix Workspace 应用程序
要安装 VDA 和 Citrix Workspace 应用程序,请指定
/components vda,plugins
。如果省略
plugins
选项,则仅安装 VDA(不安装 Citrix Workspace 应用程序)。此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。该安装程序不能安装 Citrix Workspace 应用程序。 -
-
/controllers “controller [*controller*]…”
可与 VDA 通信的 Citrix Cloud Connector 的 FQDN,以空格分隔并用直引号引起。请勿同时指定
/site_guid
和/controllers
选项。 -
/disableexperiencemetrics
防止将安装、升级或删除过程中收集的分析自动上载到 Citrix。
-
/enable_hdx_ports
如果检测到 Windows 防火墙服务,即使防火墙未启用,也会在 Windows 防火墙中打开 VDA 和启用的功能(Windows 远程协助除外)所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 HDX 自适应传输功能使用的 UDP 端口,除
/enable_hdx_ports
选项外,还请指定/enable_hdx_udp_ports
选项。 -
/enable_hdx_udp_ports
如果检测到 Windows 防火墙服务,即使未启用防火墙,也请在 Windows 防火墙中打开 HDX 自适应传输功能需要的 UDP 端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 VDA 使用的端口,除
/enable_hdx_udp_ports
选项外,还请指定/enable_hdx_ports
选项。 -
/enable_real_time_transport
为音频数据包(实时音频传输)启用或禁用 UDP。启用该功能可提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口,请包含
/enable_hdx_ports
选项。 -
/enable_remote_assistance
在 Windows 远程协助中启用重影功能以与监视功能结合使用。如果指定此选项,Windows 远程协助将在防火墙中打开动态端口。
-
/enablerestore 或 /enablerestorecleanup
(仅对单会话 VDA 有效)启用在 VDA 安装或升级失败时自动返回到还原点。
如果安装/升级成功完成:
-
/enablerestorecleanup
指示安装程序删除还原点。 -
/enablerestore
指示安装程序保留还原点,即使还原点未使用。
有关详细信息,请参阅安装或升级失败时还原。
-
-
/enable_ss_ports
如果检测到 Windows 防火墙服务,即使未启用防火墙,也请在 Windows 防火墙中打开屏幕共享所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。
-
/exclude “component”[,”component”]
阻止安装一个或多个逗号分隔的可选组件,其中每个组件两边用直引号引起。例如,在 MCS 托管的映像上安装或升级 VDA 需要 Machine Identity Service 组件。有效值为:
- Machine Identity Service
- Citrix Profile Management
- Citrix Profile Management WMI 插件
- Citrix Personalization for App-V - VDA
- Citrix Supportability Tools
- Citrix MCS IODriver
- Citrix VDA 升级代理
- Citrix Rendezvous V2
将 Citrix Profile Management 排除在安装之外 (
/exclude "Citrix Profile Management"
) 将影响从监视选显卡对 VDA 执行的监视和故障排除操作。在“用户详细信息”和“端点”页面上,“个性化”面板和“登录时长”面板失败。在“控制板”和“趋势”页面上,“平均登录持续时间”面板仅显示安装了 Profile Management 的计算机的数据。即使您使用的是第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。
如果您计划使用 MCS 预配 VM,请勿排除 Machine Identity Service。
如果您使用相同的组件名称同时指定
/exclude
和/includeadditional
,则不会安装该组件。此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。该安装程序会自动排除这些项目中的很多项。 -
/h 或 /help
显示命令帮助。
-
/includeadditional “component”[,”component”] …
包括安装一个或多个逗号分隔的可选组件,其中每个组件两边用直引号引起。组件名称区分大小写。
创建 Remote PC Access 部署并要安装默认情况下不包含的组件时,此选项很有用。有效值为:
- Citrix Profile Management
- Citrix Profile Management WMI 插件
- Citrix Personalization for App-V - VDA
- Citrix Supportability Tools
- Citrix MCS IODriver
- Citrix VDA 升级代理
- Citrix Rendezvous V2
- 用户个性化层
- Citrix Web Socket VDA 注册工具
如果您使用相同的组件名称同时指定
/exclude
和/includeadditional
,则不会安装该组件。 -
/installdir directory
用于安装组件的现有空目录。默认为 c:\Program Files\Citrix。
-
/install_mcsio_driver
请勿使用。相反,请使用
/includeadditional "Citrix MCS IODriver"
或/exclude "Citrix MCS IODriver"
-
/logpath path
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认路径为 %TEMP%\Citrix\XenDesktop Installer
此选项在图形界面中不可用。
-
/masterimage
仅当在 VM 上安装 VDA 时有效。将 VDA 设置为映像。此选项相当于
/mastermcsimage
。此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。 -
/mastermcsimage
指定此计算机将与 Machine Creation Services 一起用作映像。此选项相当于
/masterimage
。 -
/masterpvsimage
指定此计算机将作为映像与 Citrix Provisioning 或第三方预配工具(例如 Microsoft System Center Configuration Manager)结合使用。
-
/no_mediafoundation_ack
确认不安装 Microsoft 媒体基础,并且多项 HDX 多媒体功能将不安装并且无法运行。如果忽略此操作,并且不安装媒体基础,VDA 安装将失败。大多数受支持的 Windows 版本都已附带安装 Microsoft 媒体基础,但 N 版本例外。
-
/nodesktopexperience
仅在安装多会话操作系统 VDA 时有效。阻止启用增强的桌面体验功能。此功能还受增强的桌面体验 Citrix 策略设置的控制。
-
/noreboot
防止在安装完成后重新启动。重新启动后,才能使用 VDA。
-
/noresume
默认情况下,当安装过程中需要计算机重新启动时,安装程序将在重新启动完成后自动继续运行。要覆盖默认值,请指定
/noresume
。如果在自动安装过程中必须重新装载介质或者要捕获信息,这将非常有用。 -
/portnumber port
仅当指定
/reconfig
选项时有效。用于在 VDA 和 Controller 之间进行通信的端口号。先前配置的端口如果不是 80,则会被禁用。 -
/proxyconfig“地址或 PAC 文件路径”
仅当命令包含
/includeadditional "Citrix Rendezvous V2"
时才有效。与 Rendezvous 协议一起使用的代理的地址或 PAC 文件路径。有关功能详细信息,请参阅 Rendezvous 协议。- 代理地址格式:
http://<url-or-ip>:<port>
- PAC 文件格式:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- 代理地址格式:
-
/quiet 或 /passive
安装过程中不显示任何用户界面。只能在 Windows 任务管理器中找到安装和配置过程的证据。如果忽略此选项,将启动图形界面。
-
/reconfigure
与
/portnumber
、/controllers
或/enable_hdx_ports
选项结合使用时,自定义先前配置的 VDA 设置。如果指定此选项时未指定/quiet
选项,将启动用于自定义 VDA 的图形界面。 -
/remotepc
仅适用于 Remote PC Access 部署(单会话操作系统)或中转连接(多会话操作系统)。
此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。该安装程序会自动排除这些组件的安装。 -
/remove_appdisk_ack
授权 VDA 安装程序卸载 AppDisk VDA 插件(如果已安装)。
-
/remove_pvd_ack
授权 VDA 安装程序卸载 Personal vDisk(如果已安装)。
-
/remove
删除通过
/components
选项指定的组件。 -
/removeall
删除 VDA。它不会删除 Citrix Workspace 应用程序(如果已安装)。
-
/sendexperiencemetrics
将安装、升级或删除过程中收集的分析自动发送到 Citrix。如果忽略此选项(或指定了
/disableexperiencemetrics
选项),分析会在本地收集,但不会自动发送。 -
/servervdi
在受支持的 Windows 服务器上安装单会话操作系统 VDA。在 Windows 服务器上安装多会话 VDA 时,请忽略此选项。使用此选项前,请参阅服务器 VDI。
-
/site_guid guid
站点 Active Directory 组织单位 (OU) 的全局唯一标识符。使用 Active Directory 进行发现时,该标识符可将虚拟桌面与站点相关联(建议和默认的发现方法为自动更新)。站点 GUID 是在管理 > 完整配置中显示的站点属性。请勿同时指定
/site_guid
和/controllers
选项。 -
/tempdir directory
安装过程中用于保存临时文件的目录。默认路径为:c:\Windows\Temp。
此选项在图形界面中不可用。
-
/virtualmachine
仅当在 VM 上安装 VDA 时有效。通过物理机的安装程序覆盖检测功能,在安装程序中,传递给 VM 的 BIOS 信息将其显示为物理机。
此选项在图形界面中不可用。
-
/xendesktopcloud
表示 VDA 已安装在 Citrix DaaS (Citrix Cloud) 部署中。
示例:安装 VDA
-
在多会话操作系统上安装 VDA。以下命令将在多会话操作系统中安装 VDA。
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage
VDA 将用作映像。
-
安装多会话操作系统 VDA 或单会话操作系统 VDA。以下命令安装多会话操作系统 VDA 或单会话操作系统 VDA。
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot
用逗号分隔每个 Delivery Controller FQDN。请注意,
XXXX
代表 VDA 版本。 -
在单会话操作系统上安装核心服务 VDA。以下命令在单个会话操作系统上安装核心服务 VDA,用于 Remote PC Access 或 VDA 部署。
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
不安装 Citrix Workspace 应用程序和其他非核心服务。指定了 Cloud Connector 的地址,并自动打开 Windows 防火墙服务中的端口。管理员负责处理重新启动。
使用命令行自定义 VDA
安装 VDA 后,可以自定义多项设置。使用下面的一个或多个选项运行 XenDesktopVDASetup.exe
。
-
/reconfigure
(自定义 VDA 时需要) -
/h
或/help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports