使用命令行安装
本文适用于在使用 Windows 操作系统的计算机上安装组件。有关适用于 Linux 操作系统的 VDA 的信息，请参阅 Linux Virtual Delivery Agent 文档。
重要：
本文介绍如何发出产品安装命令。在开始进行任何安装之前，请查看准备安装。这篇文章提供了可用安装程序的说明。
要查看命令的执行进度和返回值，您必须是原始管理员或者使用以管理员身份运行。有关详细信息，请参阅 Microsoft 命令文档。
作为对直接使用安装命令的补充，产品 ISO 中提供了示例脚本，它们用于在 Active Directory 中安装、升级或删除 VDA 计算机。有关详细信息，请参阅使用脚本安装 VDA。
使用完整产品安装程序
要访问完整产品安装程序的命令行接口，请执行以下操作：
- 请从 Citrix 下载产品软件包。需要提供 Citrix 帐户凭据才能访问下载站点。
- 解压文件。或者刻录 ISO 文件的 DVD。
- 通过本地管理员帐户，登录要在其中安装组件的服务器。
- 在驱动器中插入 DVD 或装载 ISO 文件。
- 从介质上的
\x64\XenDesktop Setup目录中，运行相应的命令。
安装核心组件
运行 XenDesktopServerSetup.exe 命令，并使用安装核心组件的命令行选项中列出的选项。
安装 VDA
运行 XenDesktopVDASetup.exe 命令，并使用安装 VDA 的命令行选项中列出的选项。
安装通用打印服务器
按照使用命令行安装通用打印服务器中的指导进行操作。
安装联合身份验证服务
Citrix 建议使用图形界面。
安装自助服务密码重置服务
请按照自助服务密码重置服务文档中的指导进行操作。
使用独立的 VDA 安装程序
需要提供 Citrix 帐户凭据才能访问下载站点。必须在开始安装之前提升管理权限，或使用以管理员身份运行。
- 从 Citrix 下载合适的软件包：
| 下载页面上的组件名称 | 安装程序文件名 |
|---|---|
| 服务器操作系统 Virtual Delivery Agent <版本> | VDAServerSetup.exe |
| 桌面操作系统 Virtual Delivery Agent <版本> | VDAWorkstationSetup.exe |
| 桌面操作系统核心服务 Virtual Delivery Agent <版本> | VDAWorkstationCoreSetup.exe |
- 首先将软件包中的文件提取到一个现有目录，然后运行安装命令，或者只是运行该软件包。
要在安装之前提取文件，请使用 /extract 和绝对路径，例如 .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia。（该目录必须存在。否则，提取将失败。）然后，在单独的命令中，从包含所提取内容的目录（在上例中为 CitrixVDAInstallMedia）运行 XenDesktopVdaSetup.exe。请使用用于安装 VDA 的命令行选项中的有效选项。
要运行下载的软件包，只需运行其名称：VDAServerSetup.exe、VDAWorkstationSetup.exe 或 VDAWorkstationCoreSetup.exe。请使用用于安装 VDA 的命令行选项中的有效选项。
如果您熟悉完整产品安装程序：
-
请运行独立的
VDAServerSetup.exe或VDAWorkstationSetup.exe安装程序，就像它是XenDesktopVdaSetup.exe命令一样，除了名称不同。 -
VDAWorkstationCoreSetup.exe安装程序不同，因为它支持可用于其他安装程序的一部分选项。
用于安装核心组件的命令行选项
使用 XenDesktopServerSetup.exe 命令安装核心组件时，以下选项有效。有关选项的更多详细信息，请参阅安装核心组件。
/components <component> [,<component>] …
要安装或删除的组件的列表（以逗号分隔）。有效值为：
CONTROLLER：Controller
DESKTOPSTUDIO：Studio
DESKTOPDIRECTOR：Director
LICENSESERVER：Citrix 许可证服务器
如果忽略此选项，将安装所有组件（如果还指定了 /remove 选项，则删除所有组件）。
（在 7.15 LTSR CU6 之前的版本中，有效值包括 StoreFront。对于版本 7.15 LTSR CU6 及更高版本，请使用安装 StoreFront 中所述的专用 StoreFront 安装命令）。
/configure_firewall
如果 Windows 防火墙服务正在运行，即使该防火墙并未启用，也会在 Windows 防火墙中打开正在安装的组件使用的所有端口。如果您使用的是第三方防火墙或未使用防火墙，则必须手动打开这些端口。
/disableexperiencemetrics
防止将安装、升级或删除过程中收集的分析自动上载到 Citrix。
排除
阻止安装一个或多个逗号分隔的功能、服务或技术，两边用直引号括起来。有效值为：
Local Host Cache Storage (LocalDB)：防止安装用于本地主机缓存的数据库。此选项对是否安装 SQL Server Express 以用作站点数据库没有任何影响。
Smart Tools Agent：防止安装 Citrix Smart Tools Agent。
注意：
自 CU4 起，Smart Tools 不再包含在安装程序中。早期安装中存在的 Smart Tools 实例保持不变。
/help 或 /h
显示命令帮助。
/installdir <目录>
用于安装组件的现有空目录。默认值 = c:\Program Files\Citrix。
/logpath <路径>
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = "%TEMP%\Citrix\XenDesktop Installer"
/no_remote_assistance
仅当安装 Director 时有效。禁用可使用 Windows 远程协助的用户重影功能。
/noreboot
防止在安装完成后重新启动。（对于大多数核心组件，默认情况下不启用重新启动。）
/nosql
阻止在即将安装 Controller 的服务器上安装 Microsoft SQL Server Express。如果忽略此选项，将安装 SQL Server Express 以用作站点数据库。（此选项对安装用于本地主机缓存的 SQL Server Express LocalDB 没有任何影响。）
/quiet 或 /passive
安装过程中不显示任何用户界面。而只能在 Windows 任务管理器中找到安装过程的证据。如果忽略此选项，将启动图形界面。
/remove
删除通过 /components 选项指定的核心组件。
/removeall
删除已安装的所有核心组件。
/sendexperiencemetrics
将安装、升级或删除过程中收集的分析自动发送到 Citrix。如果忽略此选项（或指定了 /disableexperiencemetrics），分析会在本地收集，但不会自动发送。
/tempdir <目录>
安装过程中用于保存临时文件的目录。默认路径为：c:\Windows\Temp。
/xenapp
安装 XenApp。如果忽略此选项，则安装 XenDesktop。
示例：安装核心组件
以下命令将在服务器上安装 XenDesktop 控制器、Studio、Citrix Licensing 和 SQL Server Express。组件通信所需的防火墙端口会自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
以下命令将在服务器上安装 XenApp Controller、Studio 和 SQL Server Express。组件通信所需的防火墙端口会自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
用于安装 VDA 的命令行选项
以下选项在以下一个或多个命令中有效：XenDesktopVDASetup.exe、VDAServerSetup.exe、VDAWorkstationSetup.exe 或 VDAWorkstationCoreSetup.exe。
/baseimage
仅当在 VM 上安装 VDA for Desktop OS 时有效。为主映像启用个人虚拟磁盘。有关详细信息，请参阅 Personal vDisk。
此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。
/components <component>[,<component>]
要安装或删除的组件的列表（以逗号分隔）。有效值为：
VDA：Virtual Delivery Agent
PLUGINS：Citrix Receiver for Windows (CitrixReceiver.exe)
例如，要安装 VDA，但不安装 Citrix Receiver，请指定 /components vda。
如果忽略此选项，将安装所有组件。
此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。该安装程序不能安装 Citrix Receiver。
/controllers “<controller> [<controller>] […]”
可与 VDA 通信的 Controller 的 FQDN，以空格分隔并用直引号括起来。请勿同时指定 /site_guid 和 /controllers 选项。
/disableexperiencemetrics
防止将安装、升级或删除过程中收集的分析自动上载到 Citrix。
/enable_framehawk_port
打开 Framehawk 所使用的 UDP 端口。默认值：False
/enable_hdx_3d_pro
以 HDX 3D Pro 模式安装 VDA。
/enable_hdx_ports
如果检测到 Windows 防火墙服务，即使防火墙未启用，也会在 Windows 防火墙中打开 VDA 和启用的功能（Windows 远程协助除外）所需的端口。如果使用其他防火墙或未使用防火墙，则必须手动配置防火墙。有关端口信息，请参阅网络端口。
要打开 HDX 自适应传输功能使用的 UDP 端口，请指定 /enable_hdx_udp_ports 选项和 /enable_hdx_ports 选项。
/enable_hdx_udp_ports
如果检测到 Windows 防火墙服务，即使未启用防火墙，也请在 Windows 防火墙中打开 HDX 自适应传输功能所需的 UDP 端口。如果使用其他防火墙或未使用防火墙，则必须手动配置防火墙。有关端口信息，请参阅网络端口。
要打开 VDA 使用的其他端口，请指定 /enable_hdx_ports 选项和 /enable_hdx_udp_ports 选项。
/enable_real_time_transport
为音频数据包（实时音频传输）启用或禁用 UDP。启用该功能可提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口，请包含 /enable_hdx_ports 选项。
/enable_remote_assistance
在 Windows 远程协助中启用重影功能以与 Director 结合使用。如果指定此选项，Windows 远程协助将在防火墙中打开动态端口。
/exclude “<component>”[,”<component>”]
阻止安装一个或多个逗号分隔的可选组件，两边用直引号括起来。例如，在不受 MCS 管理的映像上安装或升级 VDA 不需要 Personal vDisk 或 Machine Identity Service 组件。有效值为：
Personal vDiskMachine Identity ServiceCitrix User Profile ManagerCitrix User Profile Manager WMI PluginCitrix Universal Print ClientCitrix Telemetry ServiceCitrix Personalization for App-V - VDA
将 Citrix Profile Management 排除在安装（使用 /exclude "Citrix User Profile Manager" 选项）之外将影响通过 Citrix Director 对 VDA 执行的监视和故障排除操作。在用户详细信息和端点页面上，个性化面板和登录持续时间面板会出现故障。在控制板和趋势页面上，平均登录持续时间面板仅显示安装了 Profile Management 的计算机的数据。
即使您使用的是第三方用户配置文件管理解决方案，Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。
此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。该安装程序会自动排除这些项目中的很多项。
/h 或 /help
显示命令帮助。
/hdxflashv2only
阻止安装 Flash 重定向旧版二进制文件以增强安全性。
此选项在图形界面中不可用。
/installdir <目录>
用于安装组件的现有空目录。默认值 = c:\Program Files\Citrix。
/logpath <路径>
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = "%TEMP%\Citrix\XenDesktop Installer"
此选项在图形界面中不可用。
/masterimage
仅当在 VM 上安装 VDA 时有效。将 VDA 设置为主映像。
此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。
/no_mediafoundation_ack
确认不安装 Microsoft 媒体基础，并且多项 HDX 多媒体功能将不安装并且无法运行。如果忽略此操作，并且不安装媒体基础，VDA 安装将失败。大多数受支持的 Windows 版本都已附带安装 Microsoft 媒体基础，但 N 版本例外。
/nocitrixwddm
仅在不包含 WDDM 驱动程序的 Windows 7 计算机上有效。禁用 Citrix WDDM 驱动程序的安装。
此选项在图形界面中不可用。
/nodesktopexperience
（仅在安装 VDA for Server OS 时有效。）阻止启用增强的桌面体验功能。此功能还受增强的桌面体验 Citrix 策略设置的控制。
/noreboot
防止在安装完成后重新启动。重新启动后，才能使用 VDA。
/noresume
默认情况下，当安装过程中需要计算机重新启动时，安装程序将在重新启动完成后自动继续运行。要覆盖默认值，请指定 /noresume。如果在自动安装过程中必须重新装载介质或者要捕获信息，这将非常有用。
/optimize
仅当在 VM 上安装 VDA 时有效。启用对虚拟机管理程序上 VM 中运行的 VDA 进行优化。VM 优化包括禁用脱机文件、禁用后台碎片整理，以及降低事件日志大小。请勿为 Remote PC Access 部署指定此选项。有关更多信息，请参阅 CTX224676。
/portnumber <端口>
仅当指定 /reconfig选项时有效。用于在 VDA 和 Controller 之间进行通信的端口号。先前配置的端口如果不是 80，则会被禁用。
/quiet 或 /passive
安装过程中不显示任何用户界面。只能在 Windows 任务管理器中找到安装和配置过程的证据。如果忽略此选项，将启动图形界面。
/reconfigure
与 /portnumber、/controllers 或 /enable_hdx_ports 选项结合使用时，自定义先前配置的 VDA 设置。如果指定此选项时未指定 /quiet 选项，将启动用于自定义 VDA 的图形界面。
/remotepc
仅适用于 Remote PC Access 部署。不在桌面操作系统中安装以下组件：
- Citrix Personalization for App-V
- Citrix User Profile Manager
- Citrix User Profile Manager WMI Plugin
- Machine Identity Service
- Personal vDisk
此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。该安装程序会自动排除这些组件的安装。
/remove
删除通过 /components 选项指定的组件。
/removeall
删除已安装的所有 VDA 组件。
/sendexperiencemetrics
将安装、升级或删除过程中收集的分析自动发送到 Citrix。如果忽略此选项（或指定了 /disableexperiencemetrics 选项），分析会在本地收集，但不会自动发送。
/servervdi
在支持的 Windows 服务器上安装 VDA for Desktop OS。在 Windows 服务器上安装 VDA for Server OS 时，请忽略此选项。使用此选项前，请参阅服务器 VDI。
此选项仅用于完整产品 VDA 安装程序。此选项在图形界面中不可用。
/site_guid <guid>
站点 Active Directory 组织单位 (OU) 的全局唯一标识符。使用 Active Directory 进行发现时，该标识符可将虚拟桌面与站点相关联（建议和默认的发现方法为自动更新）。站点 GUID 是 Studio 中显示的站点属性。请勿同时指定 /site_guid 和 /controllers 选项。
/tempdir <目录>
安装过程中用于保存临时文件的目录。默认值 = c:\Windows\Temp。
此选项在图形界面中不可用。
/virtualmachine
仅当在 VM 上安装 VDA 时有效。通过物理机的安装程序覆盖检测功能，在安装程序中，传递给 VM 的 BIOS 信息将其显示为物理机。
此选项在图形界面中不可用。
示例：安装 VDA
使用完整产品安装程序安装 VDA
以下命令将在 VM 的默认位置安装 VDA for Desktop OS 和 Citrix Receiver。此 VDA 将用作主映像。VDA 将首先注册到域 mydomain 中名为 Contr-Main 的服务器上的 Controller。VDA 将使用个人虚拟磁盘、优化功能以及 Windows 远程协助。
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance
使用 VDAWorkstationCoreSetup 独立安装程序安装桌面操作系统 VDA
以下命令在桌面操作系统上安装 Core Services VDA，以用于 Remote PC Access 或 VDI 部署。不安装 Citrix Receiver 和其他非核心服务。将会指定 Controller 的地址，且 Windows 防火墙服务中的端口将自动打开。管理员将处理重新启动。
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
使用命令行自定义 VDA
安装 VDA 后，可以自定义多项设置。从产品介质上的 \x64\XenDesktop Setup 目录，使用用于安装 VDA 的命令行选项中介绍的下列一个或多个选项，运行 XenDesktopVdaSetup.exe 命令。
-
/reconfigure（自定义 VDA 时需要） -
/h或/help /quiet/noreboot/controllers-
/portnumber端口 /enable_hdx_ports
使用命令行安装通用打印服务器
在各个打印服务器上运行下列其中一个命令：
- 在支持的 32 位操作系统上：从 Citrix 安装介质上的
\x86\Universal Print Server\目录运行UpsServer_x86.msi。 - 在支持的 64 位操作系统中：从 Citrix 安装介质上的
\x64\Universal Print Server\目录运行UpsServer_x64.msi。
在打印服务器上安装通用打印服务器组件后，请按照预配打印机中的指导对其进行配置。