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 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 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 是 Studio 中显示的站点属性。 请勿同时指定 /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 版本。

  • 在单会话操作系统上安装 Core Services 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 or /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

下一步的去向

使用命令行安装 VDA