使用命令行安装 VDA

简介

从命令行安装 VDA

1. 在要安装 VDA 的计算机上，登录到 Citrix Cloud。
2. 在左上角菜单中，选择 解决方案 > DaaS。
3. 在右上角，单击下载并选择下载 VDA。您将被重定向到 VDA 下载页面。找到所需的 VDA 安装程序，然后单击下载文件。
4. 下载完成后，运行其名称。使用本文中描述的选项。
   • 对于多会话操作系统虚拟投递代理，运行 VDAServerSetup.exe
   • 对于单会话操作系统虚拟投递代理，运行 VDAWorkstationSetup.exe
   • 对于单会话操作系统核心服务虚拟投递代理，运行 VDAWorkstationCoreSetup.exe

• 对于 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 的命令行选项

• /components 组件\[,组件\]
  逗号分隔的用于安装或删除的组件列表。有效值为：
  • VDA： 虚拟投递代理
  • PLUGINS： Citrix Workspace™ 适用于 Windows 的应用程序
  要安装 VDA 和 Citrix Workspace 应用程序，请指定 /components vda,plugins。
  如果省略 plugins 选项，则仅安装 VDA（不安装 Citrix Workspace 应用程序）。
  使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。该安装程序无法安装 Citrix Workspace 应用程序。
• /controllers "控制器 ..."
  以空格分隔的 VDA 可与其通信的 Citrix Cloud Connector FQDN，用直引号括起来。请勿同时指定 /site_guid 和 /controllers 选项。
• 禁用体验指标
  阻止自动上传在安装、升级或删除期间收集到 Citrix 的分析数据。
• /enable_hdx_ports
  如果检测到 Windows 防火墙服务，即使防火墙未启用，也会打开 VDA 和已启用功能（Windows 远程协助除外）所需的 Windows 防火墙中的端口。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅网络端口。
  要打开 HDX 自适应传输的 UDP 端口，除了 /enable_hdx_ports 选项之外，还要指定 /enable_hdx_udp_ports 选项。
• /enable_hdx_udp_ports
  如果检测到 Windows 防火墙服务，即使防火墙未启用，也会打开 HDX 自适应传输所需的 Windows 防火墙中的 UDP 端口。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅网络端口。
  要打开 VDA 使用的端口，除了 /enable_hdx_udp_ports 选项之外，还要指定 /enable_hdx_ports 选项。
• /enable\_real\_time\_transport
  启用或禁用将 UDP 用于音频数据包（用于音频的实时音频传输）。启用此功能可以提高音频性能。如果您希望在检测到 Windows 防火墙服务时自动打开 UDP 端口，请包含 /enable_hdx_ports 选项。
• /enable\_remote\_assistance
  启用 Windows 远程协助中的影子功能，以便与 Monitor 功能一起使用。如果指定此选项，Windows 远程协助将在防火墙中打开动态端口。
• /enablerestore 或 /enablerestorecleanup
  （仅适用于单会话 VDA）如果 VDA 安装或升级失败，则启用自动返回到还原点。
  如果安装/升级成功完成：
  • /enablerestorecleanup 指示安装程序删除还原点。
  • /enablerestore 指示安装程序保留还原点，即使它未被使用。
  有关详细信息，请参阅安装或升级失败时恢复。
• /enable\_ss\_ports
  如果在检测到 Windows 防火墙服务时，即使防火墙未启用，也会打开 Windows 防火墙中屏幕共享所需的端口。如果您使用不同的防火墙或不使用防火墙，则必须手动配置防火墙。
• /排除 “组件”
  阻止安装一个或多个以逗号分隔的可选组件，每个组件都用直引号括起来。例如，在 MCS 管理的映像上安装或升级 VDA 需要计算机身份服务组件。有效值为：
  • 计算机身份服务
  • Citrix 配置文件管理
  • Citrix 配置文件管理 WMI 插件
  • Citrix App-V 个性化 - VDA
  • 思杰 MCS I/O 驱动程序
  • Citrix VDA 升级代理
  • 思杰 会合 V2
  从安装中排除 Citrix Profile Management (/exclude "Citrix Profile Management") 会影响从 Monitor 控制台对 VDA 进行监视和故障排除。在用户详细信息和 EndPoint 页面上，个性化面板和登录持续时间面板将失败。在控制板和趋势页面上，平均登录持续时间面板仅显示已安装 Profile Management 的计算机的数据。
  即使您正在使用第三方配置文件管理解决方案，Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。
  如果您计划使用 MCS 预配 VM，请勿排除计算机身份服务。
  如果您同时指定 /exclude 和 /includeadditional 并使用相同的组件名称，则不会安装该组件。
  使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。该安装程序会自动排除其中许多项目。
• /h 或 /help
  显示命令帮助。
• /includeadditional "组件"\[,"组件"\] ...
  包括安装一个或多个以逗号分隔的可选组件，每个组件都用直引号括起来。组件名称区分大小写。
  当您创建远程电脑访问部署并希望安装默认不包含的组件时，此选项会很有帮助。有效值包括：
  • Citrix 配置文件管理
  • Citrix 配置文件管理 WMI 插件
  • Citrix App-V 个性化 - VDA
  • Citrix MCS I/O 驱动程序
  • Citrix VDA 升级代理
  • Citrix 会合 V2
  • 用户个性化层
  • Citrix Web Socket VDA 注册工具
  如果您同时指定 /exclude 和 /includeadditional 并使用相同的组件名称，则不会安装该组件。
• /installdir 目录
  将安装组件的现有空目录。默认值 = c:\Program Files\Citrix。
• /install_mcsio_driver
  请勿使用。请改用 /includeadditional "Citrix MCS IODriver" 或 /exclude "Citrix MCS IODriver"。
• /logpath 路径
  日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = "%TEMP%\Citrix\XenDesktop Installer"
  此选项在图形界面中不可用。
• /主映像
  仅在虚拟机上安装 VDA 时有效。将 VDA 设置为映像。此选项等同于 /mastermcsimage。
  使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。
• /MCS主映像
  指定此计算机将用作 Machine Creation Services 的映像。此选项等同于 /masterimage。
• /PVS主映像
  指定此计算机将用作 Citrix Provisioning™ 或第三方预配工具（例如 Microsoft System Center Configuration Manager）的映像。
• /no_mediafoundation_ack
  确认未安装 Microsoft Media Foundation，并且多个 HDX™ 多媒体功能未安装且无法工作。如果省略此选项且未安装 Media Foundation，则 VDA 安装将失败。大多数受支持的 Windows 版本都已安装 Media Foundation，N 版本除外。
• /nodesktopexperience（不安装桌面体验）
  仅在安装多会话操作系统 VDA 时有效。阻止启用增强桌面体验功能。此功能也通过增强桌面体验 Citrix 策略设置进行控制。
• /noreboot（禁止重新启动）
  阻止安装后重新启动。VDA 必须在重新启动后才能使用。
• /noresume（禁止恢复）
  默认情况下，如果在安装过程中需要重新启动计算机，安装程序会在重新启动完成后自动恢复。要覆盖默认设置，请指定 /noresume。如果您必须重新装载介质或希望在自动化安装期间捕获信息，这会很有帮助。
• /portnumber 端口
  仅当指定了 /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 任务管理器中。如果省略此选项，则会启动图形界面。
• /重新配置
  与 /portnumber、/controllers 或 /enable_hdx_ports 选项一起使用时，自定义以前配置的 VDA 设置。如果指定此选项但未同时指定 /quiet 选项，则会启动用于自定义 VDA 的图形界面。
• /远程电脑
  仅适用于远程电脑访问部署（单会话操作系统）或代理连接（多会话操作系统）。
  使用 VDAWorkstationCoreSetup.exe 安装程序时，此选项无效。该安装程序会自动排除这些组件的安装。
• /remove_appdisk_ack
  授权 VDA 安装程序卸载 AppDisks™ VDA 插件（如果已安装）。
• /remove_pvd_ack
  授权 VDA 安装程序卸载 Personal vDisk（如果已安装）。
• /删除
  删除使用 /components 选项指定的组件。
• /删除所有
  删除 VDA。它不会删除 Citrix Workspace 应用程序（如果已安装）。
• /发送体验指标
  在安装、升级或删除过程中自动将收集到的分析数据发送给 Citrix。如果省略此选项（或指定了 /disableexperiencemetrics 选项），则分析数据将在本地收集，但不会自动发送。
• /服务器VDI
  在受支持的 Windows 服务器上安装单会话 OS VDA。在 Windows 服务器上安装多会话 VDA 时，请省略此选项。使用此选项之前，请参阅服务器 VDI。
• /站点GUID GUID
  站点的 Active Directory 组织单位 (OU) 的全局唯一标识符。当您使用 Active Directory 进行发现时（自动更新是推荐的默认发现方法），这会将虚拟桌面与站点关联。站点 GUID 是 Studio 中显示的站点属性。请勿同时指定 /site_guid 和 /controllers 选项。
• /临时目录 目录
  安装期间用于保存临时文件的目录。默认值 = c:\Windows\Temp。
  此选项在图形界面中不可用。
• /虚拟机
  仅在 VM 上安装 VDA 时有效。覆盖安装程序对物理机的检测，因为传递给 VM 的 BIOS 信息使其显示为物理机。
  此选项在图形界面中不可用。
• /XenDesktop云
  指示 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
  每个交付控制器™ FQDN 用逗号分隔。请注意，XXXX 表示 VDA 版本。
• 在单会话操作系统上安装核心服务 VDA。 以下命令在单会话操作系统上安装核心服务 VDA，用于远程电脑访问或 VDA 部署。
  VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
  不会安装 Citrix Workspace 应用程序和其他非核心服务。指定了 Cloud Connector 的地址，并且 Windows 防火墙服务中的端口会自动打开。管理员负责处理重新启动。

使用命令行自定义 VDA

• /reconfigure（自定义 VDA 时必需）
• /h 或 /help
• /quiet
• /noreboot
• /controllers
• /portnumber port
• /enable_hdx_ports

下一步

• 创建计算机目录
• 要查看整个配置过程，请参阅规划和构建部署。