Citrix DaaS™

使用命令行安装 VDA

简介

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

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

从命令行安装 VDA

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

  1. 在要安装 VDA 的计算机上,登录 Citrix Cloud
  2. 在左上角菜单中,选择解决方案 > DaaS
  3. 在右上角,单击下载并选择下载 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

    • PLUGINS: Citrix Workspace™ app for Windows

    要安装 VDA 和 Citrix Workspace app,请指定 /components vda,plugins

    如果省略 plugins 选项,则仅安装 VDA(不安装 Citrix Workspace app)。

    使用 VDAWorkstationCoreSetup.exe 安装程序时,此选项无效。该安装程序无法安装 Citrix Workspace app。

  • /controllerscontroller [controller]…”

    Citrix Cloud Connector 的 FQDN(完全限定域名)列表,以空格分隔,VDA 可与其通信,并用直引号引起来。请勿同时指定 /site_guid/controllers 选项。

  • /disableexperiencemetrics

    阻止将安装、升级或删除过程中收集的分析数据自动上传到 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 用于音频数据包(用于音频的 RealTime Audio Transport)。启用此功能可以提高音频性能。如果希望在检测到 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 Plug-in
    • Citrix Personalization for App-V - VDA
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2

    从安装中排除 Citrix Profile Management (/exclude "Citrix Profile Management") 会影响从监视器控制台对 VDA 进行监视和故障排除。在用户详细信息EndPoint 页面上,“个性化”面板和“登录持续时间”面板将失败。在控制板趋势页面上,“平均登录持续时间”面板仅显示已安装 Profile Management 的计算机的数据。

    即使您使用的是第三方 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 Plug-in
    • Citrix Personalization for App-V - VDA
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2
    • User personalization layer
    • Citrix Web Socket VDA Registration Tool

    如果同时指定 /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 Media Foundation,并且未安装多个 HDX™ 多媒体功能且无法正常工作。如果省略此选项且未安装 Media Foundation,则 VDA 安装将失败。大多数受支持的 Windows 版本都已安装 Media Foundation,N 版本除外。

  • /nodesktopexperience

    仅在安装多会话操作系统 VDA 时有效。阻止启用增强桌面体验功能。此功能也由增强桌面体验 Citrix 策略设置控制。

  • /noreboot

    阻止安装后重新启动。VDA 必须在重新启动后才能使用。

  • /noresume

    默认情况下,如果在安装过程中需要重新启动计算机,安装程序将在重新启动完成后自动恢复。要覆盖默认设置,请指定 /noresume。如果您必须重新装载介质或希望在自动安装期间捕获信息,此功能会很有用。

  • /portnumber port

    仅在指定 /reconfig 选项时有效。用于启用 VDA 与 Controller 之间通信的端口号。除非是端口 80,否则以前配置的端口将被禁用。

  • /proxyconfigaddress or PAC file path

    仅当命令包含 /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 安装程序卸载 AppDisks™ VDA 插件(如果已安装)。

  • /remove_pvd_ack

    授权 VDA 安装程序卸载 Personal vDisk(如果已安装)。

  • /remove

    删除使用 /components 选项指定的组件。

  • /removeall

    删除 VDA。它不会删除 Citrix Workspace app(如果已安装)。

  • /sendexperiencemetrics

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

  • /servervdi

    在受支持的 Windows 服务器上安装单会话操作系统 VDA。在 Windows 服务器上安装多会话 VDA 时,请省略此选项。在使用此选项之前,请参阅 Server 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 版本。

  • 在单会话操作系统上安装核心服务 VDA。 以下命令在单会话操作系统上安装核心服务 VDA,以用于 Remote PC Access 或 VDA 部署。

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

    不安装 Citrix Workspace app 和其他非核心服务。指定 Cloud Connector 的地址,并且 Windows 防火墙服务中的端口会自动打开。管理员负责处理重新启动。

使用命令行自定义 VDA

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

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

后续步骤

使用命令行安装 VDA