Citrix DaaS

使用命令行安装vda

简介

本文适用于在Windows操作系统的机器上安装、升级和定制虚拟交付代理(Virtual Delivery agent, vda)。

本文描述如何发出VDA安装命令。在开始安装之前,请检查安装的共识了解安装注意事项、安装程序以及在安装期间指定的内容。

从命令行安装VDA

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

  1. 在安装VDA的机器上,登录到Citrix云
  2. 在左上菜单中,选择My Services > DaaS
  3. 2 .单击右上角的下载并选择下载的共识.你被重定向到VDA下载页面.找到所需的VDA安装程序并单击下载文件
  4. 下载完成后,运行它的名称。使用本文中描述的选项。

    • 对于多会话操作系统Virtual Delivery Agent,执行VDAServerSetup.exe

    • 对于单会话操作系统Virtual Delivery Agent,执行VDAWorkstationSetup.exe

    • 对于单会话的OS Core Services Virtual Delivery Agent,执行VDAWorkstationCoreSetup.exe

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

  • VDAServerSetup_XXXX.exe、运行\ extract \Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe

  • VDAWorkstationCoreSetup_XXXX.exe、运行\ extract \Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe

  • VDAWorkstationSetup_XXXX.exe、运行\ extract \Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe

命令行选项用于安装VDA

以下选项对一个或多个命令有效:VDAServerSetup.exeVDAWorkstationSetup.exe,VDAWorkstationCoreSetup.exe

  • /组件组件(,组件

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

    • 的共识:虚拟送货代理

    • 插件:思杰工作空间应用程序的Windows

    要安装VDA和Citrix Workspace应用程序,请指定/组件的共识,插件

    如果插件选项被省略,只安装VDA(而不是Citrix Workspace应用程序)。

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

  • /控制器控制器控制器)……”

    用空格分隔的Citrix云连接器的fqdn, VDA可以与之通信,用直引号括起来。不要同时指定/ site_guid而且/控制器选项。

  • / disableexperiencemetrics

    防止在安装、升级或移除Citrix期间自动上传收集的分析。

  • / enable_hdx_ports

    如果检测到Windows防火墙服务,即使防火墙未启用,也会打开VDA所需的Windows防火墙端口和已启用的功能(Windows Remote Assistance除外)。如果您使用不同的防火墙或没有防火墙,则必须手动配置防火墙。有关端口信息,请参见网络端口

    要打开HDX自适应传输的UDP端口,请指定/ enable_hdx_udp_ports选项,除了/ enable_hdx_ports选择。

  • / enable_hdx_udp_ports

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

    要打开VDA使用的端口,请指定/ enable_hdx_ports选项,除了/ enable_hdx_udp_ports选择。

  • / enable_real_time_transport

    启用或禁用对音频包使用UDP(音频的实时音频传输)。启用此功能可以提高音频性能。包括/ enable_hdx_ports选项,如果您想在检测到Windows防火墙服务时自动打开UDP端口。

  • / enable_remote_assistance

    控件中启用Windows远程帮助中的阴影功能监控功能。如果指定此选项,Windows远程协助将在防火墙中打开动态端口。

  • / enablerestore/ enablerestorecleanup

    (仅对单会话VDA有效)当VDA安装或升级失败时,自动返回到还原点。

    如果安装/升级成功:

    • / enablerestorecleanup指示安装程序删除还原点。
    • / enablerestore指示安装程序保留还原点,即使没有使用该还原点。

    详细信息请参见在安装或升级失败时恢复

  • / enable_ss_ports

    如果检测到Windows防火墙服务,即使防火墙未启用,也会在Windows防火墙中打开屏幕共享所需的端口。如果您使用不同的防火墙或没有防火墙,则必须手动配置防火墙。

  • /排除组件“,”组件”)

    防止安装一个或多个用逗号分隔的可选组件,每个组件都用直引号括起来。例如,在mcs管理的映像上安装或升级VDA需要使用机器标识服务组件。有效值为:

    • 机器识别服务
    • Citrix配置文件管理
    • Citrix配置文件管理WMI插件
    • Citrix个性化应用程序- v - VDA
    • Citrix支持工具
    • Citrix MCS IODriver
    • Citrix VDA升级代理
    • Citrix Rendezvous V2

    从安装中排除Citrix配置文件管理(/排除“Citrix配置文件管理”)影响vda的监控和故障排除监控选项卡。在用户详细信息而且端点页面、“个性化”面板和“登录持续时间”面板失败。在指示板而且趋势页中,“平均登录持续时间”面板仅显示安装了配置文件管理的计算机的数据。

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

    如果使用MCS发放虚拟机,请不要排除机器识别服务。

    如果同时指定/排除而且/ includeadditional如果组件名称相同,则不会安装该组件。

    属性时,此选项无效VDAWorkstationCoreSetup.exe安装程序。安装程序会自动排除其中的许多项。

  • /小时/帮助

    显示命令帮助。

  • / includeadditional组件“,”组件“)…

    包括一个或多个用逗号分隔的可选组件的安装,每个组件都用直引号括起来。组件名称区分大小写。

    当您正在创建Remote PC Access部署,并且希望安装默认情况下未包含的组件时,此选项可能很有帮助。有效值为:

    • Citrix配置文件管理
    • Citrix配置文件管理WMI插件
    • Citrix个性化应用程序- v - VDA
    • Citrix支持工具
    • Citrix MCS IODriver
    • Citrix VDA升级代理
    • Citrix Rendezvous V2
    • 用户个性化层
    • Citrix Web Socket VDA注册工具

    如果同时指定/排除而且/ includeadditional如果使用相同的组件名称,则不会安装该组件。

  • / installdir目录

    将在其中安装组件的现有空目录。默认值= c:\Program Files\Citrix.

  • / install_mcsio_driver

    不要使用。相反,使用/include额外的“Citrix MCS IODriver”/排除“Citrix MCS IODriver”

  • / logpath路径

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

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

  • / masterimage

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

    属性时,此选项无效VDAWorkstationCoreSetup.exe安装程序。

  • / mastermcsimage

    指定此机器将在“机器创建服务”中用作映像。此选项相当于/ masterimage

  • / masterpvsimage

    指定此计算机将作为Citrix Provisioning或第三方Provisioning工具(如Microsoft System Center Configuration Manager)的映像使用。

  • / no_mediafoundation_ack

    确认未安装Microsoft Media Foundation,若干HDX多媒体功能未安装且无法工作。如果省略该选项,且未安装Media Foundation,则VDA安装失败。除N个版本外,大多数受支持的Windows版本都已安装Media Foundation。

  • / nodesktopexperience

    仅在安装多会话操作系统VDA时有效。阻止启用“增强的桌面体验”功能。该特性还可以通过Enhanced Desktop Experience Citrix策略设置进行控制。

  • / noreboot

    防止安装后重新启动。VDA重启后才能使用。

  • / noresume

    默认情况下,当安装过程中需要重新启动计算机时,安装程序将在重新启动完成后自动恢复。要覆盖默认值,请指定/ noresume.如果必须重新挂载媒体或希望在自动安装期间捕获信息,这可能很有帮助。

  • / portnumber港口

    仅当/ reconfig选项。用于VDA和控制器之间通信的端口号。先前配置的端口被禁用,除非它是端口80。

  • / proxyconfig地址或PAC文件路径

    仅当命令包含/ incldeextra“Citrix Rendezvous V2”.用于集合协议的代理的地址或PAC文件路径。有关特性的详细信息,请参见对接协议

    • 代理地址格式:http:// < url-or-ip >: <口>
    • PAC文件格式:http:// < url-or-ip >: <口> / <路径> / <文件名> .pac
  • /安静/被动

    安装过程中不会出现任何用户界面。安装和配置过程的唯一证据是在Windows任务管理器中。如果省略此选项,则启动图形界面。

  • /重新配置

    控件一起使用时,自定义以前配置的VDA设置/ portnumber/控制器,或/ enable_hdx_ports选项。如果指定此选项而不指定/安静选项,用于自定义VDA启动的图形界面。

  • / remotepc

    仅对远程PC访问部署(单会话操作系统)或代理连接(多会话操作系统)有效。

    属性时,此选项无效VDAWorkstationCoreSetup.exe安装程序。该安装程序自动排除这些组件的安装。

  • / remove_appdisk_ack

    授权VDA安装程序卸载已安装的AppDisks VDA插件。

  • / remove_pvd_ack

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

  • /删除

    属性指定的组件/组件选择。

  • / removeall

    移除VDA。它不会删除Citrix Workspace应用程序(如果已安装)。

  • / sendexperiencemetrics

    自动将在安装、升级或删除期间收集的分析发送到Citrix。如果省略此选项(或/ disableexperiencemetrics选项),分析将在本地收集,但不会自动发送。

  • / servervdi

    在受支持的Windows服务器上安装单会话操作系统VDA。在Windows服务器上安装多会话VDA时,请忽略此选项。在使用此选项之前,请参见服务器VDI

  • / site_guidguid

    站点OU (Active Directory organization Unit)的全局唯一标识。这将在您使用Active Directory进行发现时将虚拟桌面与站点关联(自动更新是推荐的和默认的发现方法)。站点GUID是中显示的站点属性管理>满配.不要同时指定/ site_guid而且/控制器选项。

  • / tempdir目录

    目录,用于在安装期间保存临时文件。默认值= c:\Windows\Temp.

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

  • / virtualmachine

    仅当在虚拟机上安装VDA时有效。覆盖物理机安装程序的检测,其中传递给vm的BIOS信息使它们显示为物理机。

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

  • / xendesktopcloud

    表示VDA安装在Citrix DaaS (Citrix Cloud)部署中。

示例:安装VDA

以下命令在多会话操作系统上安装VDA。VDA将用作映像。

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

以下命令在单会话操作系统上安装Core Services VDA,用于远程PC访问或VDI部署。未安装Citrix Workspace app等非核心服务。指定云连接器的地址后,Windows防火墙服务中的端口将自动打开。管理员处理重启。

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

使用命令行定制VDA

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

  • /重新配置(自定义VDA时需要)
  • /小时/帮助
  • /安静
  • / noreboot
  • /控制器
  • / portnumber港口
  • / enable_hdx_ports

下一步去哪里

使用命令行安装vda