使用命令行进行安装
本文适用于在 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
使用 安装 VDA 的命令行选项 中列出的选项运行 XenDesktopVDASetup.exe 命令。
如何安装通用打印服务器
请遵循 使用命令行安装通用打印服务器 中的指导。
如何安装联合身份验证服务
Citrix 建议使用图形界面。
执行自助服务密码重置服务的安装
请查阅自助密码重置服务文档，以获取相关指导。
使用独立 VDA 安装程序
访问下载站点需要 Citrix 帐户凭据。您必须在开始安装之前拥有提升的管理权限，或者使用 以管理员身份运行。
- 从 Citrix 下载相应的软件包：
| 下载页面上的组件名称 | 安装程序文件名 |
|---|---|
| 服务器操作系统虚拟投递代理 <版本> | VDA服务器安装.exe |
| 桌面操作系统虚拟投递代理 <version> | VDA工作站安装.exe |
| 桌面操作系统核心服务虚拟投递代理 <version> | 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: 控制器
DESKTOPSTUDIO: 思杰工作室
DESKTOPDIRECTOR: 思杰总监
LICENSESERVER: Citrix 许可证服务器
如果省略此选项，将安装所有组件（如果同时指定了 /remove 选项，则会将其删除）。
(在 7.15 LTSR CU6 之前的版本中，有效值包括 StoreFront。对于 7.15 LTSR CU6 及更高版本，请使用 安装 StoreFront 中所述的专用 StoreFront 安装命令。)
配置防火墙
如果 Windows 防火墙服务正在运行，即使防火墙未启用，也会打开正在安装的组件在 Windows 防火墙中使用的所有端口。如果您使用的是第三方防火墙或没有防火墙，则必须手动打开端口。
/禁用体验指标
阻止在安装、升级或删除过程中收集的分析数据自动上传到 Citrix。
/排除
阻止安装一个或多个用直引号括起来的、以逗号分隔的功能、服务或技术。有效值包括：
Local Host Cache Storage (LocalDB): 阻止安装用于本地主机缓存的数据库。此选项对是否安装 SQL Server Express 作为站点数据库没有影响。
Smart Tools Agent: 此选项将阻止安装名为 Citrix Smart Tools 的代理程序。
注意：
自 CU4 起，安装程序中不再包含 Smart Tools。早期安装中存在的 Smart Tools 实例保持不变。
显示帮助信息：/help 或 /h
显示命令帮助。
安装目录 <目录>
将安装组件的现有空目录。默认值 = c:\Program Files\Citrix。
/logpath <path>
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = "%TEMP%\Citrix\XenDesktop Installer"
不启用远程协助
仅在安装 Director 时有效。禁用使用 Windows 远程协助的用户影子功能。
不重启
阻止安装后重新启动。（对于大多数核心组件，默认情况下不启用重新启动。）
/nosql
阻止在安装 Controller 的服务器上安装 Microsoft SQL Server Express。如果省略此选项，则会安装 SQL Server Express 作为站点数据库使用。（此选项对用于本地主机缓存的 SQL Server Express LocalDB 的安装没有影响。）
静默或被动安装：/quiet 或 /passive
安装期间不显示用户界面。安装过程的唯一证据在 Windows 任务管理器中。如果省略此选项，则会启动图形界面。
/移除
移除使用 /components 选项指定的核心组件。
/移除所有
移除所有已安装的核心组件。
/发送体验指标
自动将安装、升级或移除期间收集的分析数据发送给 Citrix。如果省略此选项（或指定 /disableexperiencemetrics），则分析数据将在本地收集，但不会自动发送。
/临时目录 <目录>
在安装期间保存临时文件的目录。默认值 = c:\Windows\Temp。
/xenapp
安装 XenApp。如果省略此选项，则会安装 XenDesktop®。
示例：安装核心组件
以下命令将在服务器上安装 XenDesktop 控制器、Studio、Citrix 许可和 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。
/基础镜像
仅在虚拟机上安装桌面操作系统 VDA 时有效。启用将 Personal vDisk 与主映像结合使用。有关详细信息，请参阅 Personal vDisk。
使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。
/组件 <组件>[,<component>]
要安装或删除的组件的逗号分隔列表。有效值为：
VDA: 虚拟投递代理
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 选项。
/禁用体验指标
阻止在安装、升级或删除过程中收集的分析数据自动上传到 Citrix。
/启用_弗雷姆霍克_端口
打开 Framehawk 使用的 UDP 端口。默认不启用。
/enable_hdx_3d_pro
此选项将 VDA 安装为 HDX™ 3D Pro 模式。
/启用_HDX_端口
如果检测到 Windows 防火墙服务，即使防火墙未启用，也会打开 VDA 和已启用功能（Windows 远程协助除外）所需的 Windows 防火墙中的端口。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅网络端口。
要打开 HDX 自适应传输使用的 UDP 端口，请指定 /enable_hdx_udp_ports 选项和 /enable_hdx_ports 选项。
启用 HDX UDP 端口
如果检测到 Windows 防火墙服务，即使防火墙未启用，也会打开 HDX 自适应传输所需的 Windows 防火墙中的 UDP 端口。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅网络端口。
要打开 VDA 使用的其他端口，请指定 /enable_hdx_ports 选项和 /enable_hdx_udp_ports 选项。
/启用_实时传输
启用或禁用将 UDP 用于音频数据包（音频的实时音频传输）。启用此功能可以提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口，请包含 /enable_hdx_ports 选项。
/启用_远程协助
启用 Windows 远程协助中的阴影功能，以便与 Director 结合使用。如果指定此选项，Windows 远程协助将在防火墙中打开动态端口。
/排除 “<组件>”[,”<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 配置文件管理服务。不需要启用 Citrix 配置文件管理服务。
使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。该安装程序会自动排除其中许多项目。
/h or /help
显示命令帮助。
/hdxflashv2only
阻止安装 Flash 重定向旧版二进制文件，以增强安全性。
此选项在图形用户界面中不可用。
/installdir <directory>
将安装组件的现有空目录。默认值 = c:\Program Files\Citrix。
/logpath <path>
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = "%TEMP%\Citrix\XenDesktop Installer"
此选项在图形用户界面中不可用。
主映像
仅在虚拟机上安装 VDA 时有效。将 VDA 设置为主映像。
使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。
无媒体基础确认
确认未安装 Microsoft Media Foundation，并且多个 HDX 多媒体功能将不会安装且无法工作。如果省略此选项且未安装 Media Foundation，则 VDA 安装将失败。大多数受支持的 Windows 版本都已安装 Media Foundation，N 版本除外。
/无思杰WDDM驱动程序
仅在不包含 WDDM 驱动程序的 Windows 7 计算机上有效。禁用 Citrix WDDM 驱动程序的安装。
此选项在图形用户界面中不可用。
无桌面体验
仅在安装服务器操作系统 VDA 时有效。阻止启用增强桌面体验功能。此功能也通过增强桌面体验 Citrix 策略设置进行控制。
/不重启
阻止安装后重新启动。VDA 必须在重新启动后才能使用。
/不恢复
默认情况下，如果在安装过程中需要重新启动计算机，安装程序会在重新启动完成后自动恢复。要覆盖默认设置，请指定 /noresume。如果您必须重新装载介质或希望在自动化安装期间捕获信息，这会很有帮助。
/优化
仅在虚拟机上安装 VDA 时有效。为在虚拟机管理程序上的虚拟机中运行的 VDA 启用优化。虚拟机优化包括禁用脱机文件、禁用后台碎片整理以及减小事件日志大小。请勿为远程电脑访问部署指定此选项。有关详细信息，请参阅 CTX224676。
/端口号 <端口>
仅在指定 /reconfig 选项时有效。用于启用 VDA 与控制器之间通信的端口号。除非是端口 80，否则以前配置的端口将被禁用。
静默或被动
安装期间不会出现用户界面。安装和配置过程的唯一证据在 Windows 任务管理器中。如果省略此选项，则会启动图形界面。
重新配置
与 /portnumber、/controllers 或 /enable_hdx_ports 选项一起使用时，自定义以前配置的 VDA 设置。如果您在未同时指定 /quiet 选项的情况下指定此选项，则会启动用于自定义 VDA 的图形界面。
远程电脑访问
仅适用于远程电脑访问部署。在桌面操作系统上排除安装以下组件：
- 适用于 App-V 的 思杰 个性化
- Citrix 用户配置文件管理器
- Citrix 用户配置文件管理器 WMI 插件
- 计算机身份服务
- 个人虚拟磁盘
使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。该安装程序会自动排除这些组件的安装。
/移除
删除使用 /components 选项指定的组件。
/移除所有
删除所有已安装的 VDA 组件。
/发送体验指标
自动将安装、升级或删除期间收集的分析数据发送给 Citrix。如果省略此选项（或指定了 /disableexperiencemetrics 选项），则分析数据将在本地收集，但不会自动发送。
服务器 VDI
在受支持的 Windows 服务器上安装适用于桌面操作系统的 VDA。在 Windows 服务器上安装适用于服务器操作系统的 VDA 时，请省略此选项。使用此选项之前，请参阅 Server VDI。
仅将此选项与完整产品 VDA 安装程序一起使用。此选项在图形界面中不可用。
/site_guid <全局唯一标识符>
站点的 Active Directory 组织单位 (OU) 的全局唯一标识符。当您使用 Active Directory 进行发现时（自动更新是推荐的默认发现方法），此项会将虚拟桌面与站点关联。站点 GUID 是在 Studio 中显示的站点属性。不要同时指定 /site_guid 和 /controllers 选项。
/tempdir <directory>
安装期间用于存放临时文件的目录。默认值 = c:\Windows\Temp。
此选项无法通过图形界面进行操作。
/虚拟机
仅在虚拟机上安装 VDA 时有效。覆盖安装程序对物理机的检测，在这种情况下，传递给虚拟机的 BIOS 信息会使它们显示为物理机。
此选项无法通过图形界面进行配置。
示例：安装 VDA
使用完整产品安装程序安装 VDA
以下命令在虚拟机上的默认位置安装适用于桌面操作系统和 Citrix Receiver™ 的 VDA。此 VDA 将用作主映像。VDA 将首先在域“mydomain”中名为“Contr-Main”的服务器上向 Controller 注册。VDA 将使用 Personal vDisks、优化功能和 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
以下命令在桌面操作系统上安装核心服务 VDA，用于远程 PC 访问或 VDI 部署。不会安装 Citrix Receiver 和其他非核心服务。指定了 Controller 的地址，并且 Windows 防火墙服务中的端口将自动打开。管理员将处理重新启动。
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
使用命令行自定义 VDA
安装 VDA 后，您可以自定义多项设置。从产品介质上的 \x64\XenDesktop Setup 目录中，运行 XenDesktopVdaSetup.exe 命令，并使用以下一个或多个选项（这些选项在用于安装 VDA 的命令行选项中进行了介绍）。
-
/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。
在打印服务器上安装通用打印服务器组件后，请按照预配打印机中的指导对其进行配置。