Citrix DaaS

使用命令行安装 VDA

简介

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

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

从命令行安装 VDA

要安装 VDA(并查看命令执行进度和返回值),必须具有更高的管理权限或使用以管理员身份运行

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

    • 对于多会话操作系统 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.exeVDAWorkstationSetup.exeVDAWorkstationCoreSetup.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 应用程序。

  • /controllerscontroller [*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 防火墙中打开屏幕共享所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。

  • /excludecomponent”[,”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

    显示命令帮助。

  • /includeadditionalcomponent”[,”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 /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

    用逗号分隔每个 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

下一步的去向

使用命令行安装 VDA