使用命令行安装 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 /masterimageVDA 将用作映像。
-
安装多会话操作系统 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