使用命令行安装 VDA

重要提示:

如果要升级安装了 Personal vDisk (PvD) 组件的 VDA,请参阅关于升级 VDA 的重要通知

简介

本文适用于在使用 Windows 操作系统的计算机上安装、升级和自定义 Virtual Delivery Agent (VDA)。

本文介绍如何发出 VDA 安装命令。开始安装之前,请查看安装 VDA 以了解与安装注意事项、安装程序以及您在安装过程中指定的内容有关的信息。

从命令行安装 VDA

在安装 VDA 软件之前,请确保计算机已加入域。

您必须具有提升的管理员权限或者使用以管理员身份运行,才能安装 VDA(并查看命令的执行进度和返回值)。

  1. 在要安装 VDA 的计算机上,登录到 Citrix Cloud
  2. 在左上角菜单中,选择我的服务 > Virtual Apps and Desktops
  3. 在右上角,单击 Downloads(下载)并选择 Download VDA(下载 VDA)。您将被重定向到 VDA 下载页面。找到所需的 VDA 安装程序并单击 Download File(下载文件)。
  4. 下载完成后,运行其名称。请使用本文中介绍的选项。

    • 对于服务器操作系统 Virtual Delivery Agent,请运行 VDAServerSetup.exe

    • 对于桌面操作系统 Virtual Delivery Agent,请运行 VDAWorkstationSetup.exe

    • 对于桌面操作系统核心服务 Virtual Delivery Agent,请运行 VDAWorkstationCoreSetup.exe

要在安装之前提取文件,请使用 /extract 和绝对路径,例如 .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia。(该目录必须存在。否则,提取将失败。)然后,在单独的命令中,从包含所提取内容的目录(在上例中为 CitrixVDAInstallMedia)运行 VDAWorkstationCoreSetup.exe。请使用本文中列出的有效选项。

用于安装 VDA 的命令行选项

以下选项在一个或多个命令中有效:VDAServerSetup.exeVDAWorkstationSetup.exeVDAWorkstationCoreSetup.exe

  • /baseimage

    这项技术为已弃用。仅当在 VM 上安装 VDA for Desktop OS 时有效。为主映像启用个人虚拟磁盘。

    此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。

  • /components component[,component]

    要安装或删除的组件的列表(以逗号分隔)。有效值为:

    • VDA: Virtual Delivery Agent

    • 插件: 适用于 Windows 的 Citrix Workspace 应用程序

    要安装 VDA 和 Citrix Workspace 应用程序,请指定 /components vda,plugins

    此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。该安装程序不能安装 Citrix Workspace 应用程序。

  • /controllerscontroller [controller]…”

    可与 VDA 通信的 Citrix Cloud Connector 的 FQDN,以空格分隔并用直引号引起。请勿同时指定 /site_guid/controllers 选项。

  • /disableexperiencemetrics

    防止将安装、升级或删除过程中收集的分析自动上载到 Citrix。

  • /enable_hdx_ports

    如果检测到 Windows 防火墙服务,即使防火墙未启用,也会在 Windows 防火墙中打开 Cloud Connector 和启用的功能(Windows 远程协助除外)所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口

    要打开 HDX 自适应传输功能用于与 Controller 通信的 UDP 端口,除 /enable_hdx_ports 选项外,还请指定 /enable_hdx_udp_ports 选项。

  • /enable_hdx_udp_ports

    如果检测到 Windows 防火墙服务,即使未启用防火墙,也请在 Windows 防火墙中打开 HDX 自适应传输功能所需的 UDP 端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口

    要打开 VDA 用于与 Controller 和已启用的功能通信的端口,除 /enable_hdx_ports 选项外,还请指定 /enable_hdx_udp_ports 选项。

  • /enable_real_time_transport

    为音频数据包(实时音频传输)启用或禁用 UDP。启用该功能可提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口,请包含 /enable_hdx_ports 选项。

  • /enable_remote_assistance

    在 Windows 远程协助中启用重影功能以与监视功能结合使用。如果指定此选项,Windows 远程协助将在防火墙中打开动态端口。

  • /excludecomponent”[,”component”]

    阻止安装一个或多个逗号分隔的可选组件,其中每个组件两边用直引号引起。例如,在不受 MCS 管理的映像上安装或升级 VDA 不需要 Machine Identity Service 组件。有效值为:

    • AppDisk VDA 插件
    • Personal vDisk
    • Machine Identity Service
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrix 通用打印客户端
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Citrix Files for Windows
    • Citrix Files for Outlook

    将 Citrix Profile Management 排除在安装之外 (/exclude "Citrix User Profile Manager") 将影响从监视选显卡对 VDA 执行的监视和故障排除操作。在用户详细信息端点页面上,“个性化”面板和“登录持续时间”面板会出现故障。在控制板趋势页面上,“平均登录持续时间”面板仅显示安装了 Profile Management 的计算机的数据。

    即使您使用的是第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。

    如果您计划使用 MCS 预配 VM,请勿排除 Machine Identity Service。

    如果您同时指定 /exclude/includeadditional 与相同的组件名称,则不安装该组件。

    此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。该安装程序会自动排除这些项目中的很多项。

  • /h/help

    显示命令帮助。

  • /hdxflashv2only

    阻止安装 Flash 重定向旧版二进制文件以增强安全性。

    此选项在图形界面中不可用。

  • /includeadditionalcomponent”[,”component”] …

    包括安装一个或多个逗号分隔的可选组件,其中每个组件两边用直引号引起。创建 Remote PC Access 部署并要安装默认情况下不包含的组件时,此选项很有用。有效值为:

    • Personal vDisk
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrix 通用打印客户端
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Citrix Files for Windows
    • Citrix Files for Outlook

    如果您同时指定 /exclude/includeadditional 与相同的组件名称,则不安装该组件。

  • /installdir directory

    用于安装组件的现有空目录。默认为 c:\Program Files\Citrix。

  • /install_mcsio_driver

    启用 MCS I/O 写入缓存以实现存储优化。

  • /logpath path

    日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认路径为 %TEMP%\Citrix\XenDesktop Installer

    此选项在图形界面中不可用。

  • /masterimage

    仅当在 VM 上安装 VDA 时有效。将 VDA 设置为主映像。此选项相当于 /mastermcsimage

    此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。

  • /mastermcsimage

    指定此计算机将与 Machine Creation Services 一起用作主映像。此选项还会安装 TargetOSOptimizer.exe(除非您还指定了包括优化器安装程序的 exclude "Machine Identity Service")。此选项相当于 /masterimage

  • /masterpvsimage

    指定此计算机将作为主映像与 Citrix Provisioning 或第三方预配工具(例如 Microsoft System Center Configuration Manager)结合使用。

  • /no_mediafoundation_ack

    确认不安装 Microsoft 媒体基础,并且多项 HDX 多媒体功能将不安装并且无法运行。如果忽略此操作,并且不安装媒体基础,VDA 安装将失败。大多数受支持的 Windows 版本都已附带安装 Microsoft 媒体基础,但 N 版本例外。

  • /nodesktopexperience

    (仅在安装 VDA for Server OS 时有效。)阻止启用增强的桌面体验功能。此功能还受增强的桌面体验 Citrix 策略设置的控制。

  • /noreboot

    防止在安装完成后重新启动。重新启动后,才能使用 VDA。

  • /noresume

    默认情况下,当安装过程中需要计算机重新启动时,安装程序将在重新启动完成后自动继续运行。要覆盖默认值,请指定 /noresume。如果在自动安装过程中必须重新装载介质或者要捕获信息,这将非常有用。

  • /optimize

    使用 MCS 并启用此功能(默认)时,VM 优化将禁用脱机文件、禁用后台碎片整理并减少事件日志大小。有关详细信息,请参阅CTX125874

    除了启用此功能外,优化还要求安装 Machine Identity Service。该服务包含 TargetOSOptimizer.exe。当您指定了 /mastermcsimage/masterimage(并且未指定 /exclude "Machine Identity Service")时,Machine Identity Service 将自动安装。

  • /portnumber port

    仅当指定 /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
    • Citrix Supportability Tools
    • Citrix Files for Windows
    • Citrix Files for Outlook

    此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。该安装程序会自动排除这些组件的安装。

  • /remove

    删除通过 /components 选项指定的组件。

  • /removeall

    删除已安装的所有 VDA 组件。

  • /sendexperiencemetrics

    将安装、升级或删除过程中收集的分析自动发送到 Citrix。如果忽略此选项(或指定了 /disableexperiencemetrics 选项),分析会在本地收集,但不会自动发送。

  • /servervdi

    在支持的 Windows 服务器上安装 VDA for Desktop OS。在 Windows 服务器上安装 VDA for Server OS 时,请忽略此选项。使用此选项之前,请参阅服务器 VDI

    此选项在图形界面中不可用。

  • /site_guid guid

    站点 Active Directory 组织单位 (OU) 的全局唯一标识符。使用 Active Directory 进行发现时,该标识符可将虚拟桌面与站点相关联(建议和默认的发现方法为自动更新)。站点 GUID 是 Studio 中显示的站点属性。请勿同时指定 /site_guid/controllers 选项。

  • /tempdir directory

    安装过程中用于保存临时文件的目录。默认路径为:c:\Windows\Temp。

    此选项在图形界面中不可用。

  • /virtualmachine

    仅当在 VM 上安装 VDA 时有效。通过物理机的安装程序覆盖检测功能,在安装程序中,传递给 VM 的 BIOS 信息将其显示为物理机。

    此选项在图形界面中不可用。

示例:安装 VDA

以下命令将在服务器操作系统中安装 VDA。此 VDA 将用作主映像。

VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimge

以下命令在桌面操作系统上安装 Core Services VDA,以用于 Remote PC Access 或 VDI 部署。不安装 Citrix Workspace 应用程序和其他非核心服务。指定 Cloud Connector 的地址,并且 Windows 防火墙服务中的端口将自动打开。管理员将处理重新启动。

VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

使用命令行自定义 VDA

安装 VDA 后,可以自定义多项设置。使用下面的一个或多个选项运行 XenDesktopVDASetup.exe

  • /reconfigure(自定义 VDA 时需要)
  • /h/help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

下一步的去向

创建计算机目录

要查看整个配置过程,请参阅安装和配置