Citrix Virtual Apps and Desktops

使用命令行安装

重要:

如果要升级,并且当前版本使用或安装了 Personal vDisk 或 AppDisk 软件,请参阅删除 PvD、应用磁盘和不受支持的主机

简介

本文适用于在使用 Windows 操作系统的计算机上安装组件。有关适用于 Linux 操作系统的 VDA 的信息,请参阅 Linux Virtual Delivery Agent

本文介绍如何发出产品安装命令。在开始进行任何安装之前,请查看准备安装。这篇文章提供了可用安装程序的说明。

要查看命令的执行进度和返回值,您必须是原始管理员或者使用以管理员身份运行。有关详细信息,请参阅 Microsoft 命令文档。

作为对直接使用安装命令的补充,产品 ISO 中提供了示例脚本,用于在 Active Directory 中的计算机上安装、升级或删除 VDA。有关详细信息,请参阅使用脚本安装 VDA

如果尝试在此 Citrix Virtual Apps and Desktops 版本不支持的 Windows 操作系统版本上安装或升级,则会显示一条消息,指导您参阅与您的选项有关的信息。请参阅早期版本的操作系统

有关 Citrix 如何报告组件安装结果的信息,请参阅 Citrix 安装返回代码

使用完整产品安装程序

要访问完整产品安装程序的命令行接口,请执行以下操作:

  1. 请从 Citrix 下载产品软件包。需要提供 Citrix 帐户凭据才能访问下载站点。
  2. 解压文件。或者刻录 ISO 文件的 DVD。
  3. 通过本地管理员帐户,登录要在其中安装组件的服务器。
  4. 在驱动器中插入 DVD 或装载 ISO 文件。
  5. 从介质上的 \x64\XenDesktop Setup 目录中,运行相应的命令。

    要安装核心组件,请执行以下操作: 运行 XenDesktopServerSetup.exe,并使用安装核心组件的命令行选项中列出的选项。

    要安装 VDA,请执行以下操作: 运行 XenDesktopVDASetup.exe,并使用安装 VDA 的命令行选项中列出的选项。

    要安装 StoreFront,请执行以下操作: 运行在安装介质上的 x64 > StoreFront 文件夹中的 CitrixStoreFront-x64.exe

    要安装通用打印服务器,请执行以下操作: 请按照用于安装通用打印服务器的命令行选项中的指导进行操作。

    要安装联合身份验证服务,请执行以下操作: Citrix 建议使用图形界面。

    要安装 Session Recording,请执行以下操作: 请按照 Sesssion Recording 中的指导进行操作。

用于安装核心组件的命令行选项

使用 XenDesktopServerSetup.exe 命令安装核心组件时,以下选项有效。有关选项的更多详细信息,请参阅安装核心组件

  • /components component [,*component*] …

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

    • CONTROLLER:Controller
    • DESKTOPSTUDIO:Studio
    • DESKTOPDIRECTOR:Director
    • LICENSESERVER:Citrix 许可证服务器

    如果忽略此选项,将安装所有组件(如果还指定了 /remove 选项,则删除所有组件)。

    (在 2003 之前的版本中,有效值包括 STOREFRONT。对于版本 2003 及更高版本,请使用使用完整产品安装程序中提及的专用 StoreFront 安装命令)。

  • /configure_firewall

    如果 Windows 防火墙服务正在运行,即使该防火墙并未启用,也会在 Windows 防火墙中打开正在安装的组件使用的所有端口。如果您使用的是第三方防火墙或未使用防火墙,则必须手动打开这些端口。

  • /disableexperiencemetrics

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

  • /excludefeature”[,”feature”]

    阻止安装一个或多个逗号分隔的功能、服务或技术,其中每项功能、服务或技术两边用直引号引起。有效值为:

    • "Local Host Cache Storage (LocalDB)":防止安装用于本地主机缓存的数据库。此选项对是否安装 SQL Server Express 以用作站点数据库没有任何影响。
  • /help/h

    显示命令帮助。

  • /ignore_hw_check_failure

    允许继续安装或升级 Delivery Controller,即使硬件检查失败(例如,由于 RAM 不足)也是如此。有关详细信息,请参阅硬件检查

  • /ignore_site_test_failure

    仅在升级 Controller 过程中有效。通常情况下,任何站点测试失败问题都将被忽略,升级继续进行。如果忽略(或者设置为 false),任何站点测试失败都会导致安装程序失败,而不执行升级。默认值:False

    在升级过程中,如果检测到不受支持的 SQL Server 版本,则忽略此选项。有关详细信息,请参阅 SQL Server 版本检查

  • /installdir directory

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

  • /logpath path

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

  • /no_remote_assistance

    仅当安装 Director 时有效。禁用可使用 Windows 远程协助的用户重影功能。

  • /noreboot

    防止在安装完成后重新启动。(对于大多数核心组件,默认情况下不启用重新启动。)

  • /noresume

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

  • /nosql

    阻止在即将安装 Controller 的服务器上安装 Microsoft SQL Server Express。如果忽略此选项,将安装 SQL Server Express 以用作站点数据库。

    此选项对安装用于本地主机缓存的 SQL Server Express LocalDB 没有任何影响。

  • /quiet/passive

    安装过程中不显示任何用户界面。而只能在 Windows 任务管理器中找到安装过程的证据。如果忽略此选项,将启动图形界面。

  • /remove

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

  • /removeall

    删除已安装的所有核心组件。

  • /sendexperiencemetrics

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

  • /tempdir directory

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

  • /xenapp

    安装 Citrix Virtual Apps。如果忽略此选项,则安装 Citrix Virtual Apps and Desktops。

核心组件安装示例

以下命令将在服务器上安装 Delivery Controller、Studio、Citrix Licensing 和 SQL Server Express。组件通信所需的防火墙端口会自动打开。

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

以下命令将在服务器上安装 Citrix Virtual Apps Controller、Studio 和 SQL Server Express。组件通信所需的防火墙端口会自动打开。

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall

使用独立的 VDA 安装程序

需要提供 Citrix 帐户凭据才能访问下载站点。必须在开始安装之前提升管理权限,或使用以管理员身份运行

  1. 从 Citrix 下载合适的软件包:
    • 多会话操作系统 Virtual Delivery Agent:VDAServerSetup_xxxx.exe
    • 单会话操作系统 Virtual Delivery Agent:VDAWorkstationSetup_xxxx.exe
    • 单会话操作系统核心服务 Virtual Delivery Agent:VDAWorkstationCoreSetup_xxxx.exe
  2. 首先将软件包中的文件提取到一个现有目录,然后运行安装命令,或者只需运行该软件包。

    要在安装之前提取文件,请使用 /extract 和绝对路径,例如 C:\YourExtractFolder\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

    要运行下载的软件包,请运行其名称:VDAServerSetup.exeVDAWorkstationSetup.exeVDAWorkstationCoreSetup.exe。请使用本文中列出的有效选项。

如果您熟悉完整产品安装程序:

  • 请运行独立的 VDAServerSetup.exeVDAWorkstationSetup.exe 安装程序,就像它是 XenDesktopVdaSetup.exe 命令一样,除了名称不同。

  • VDAWorkstationCoreSetup.exe 安装程序不同,因为它支持可用于其他安装程序的一部分选项。

用于安装 VDA 的命令行选项

以下选项在以下一个或多个命令(安装程序)中有效:VDAServerSetup_xxxx.exeVDAWorkstationSetup_xxxx.exeVDAWorkstationCoreSetup_xxxx.exe

有关选项的更多详细信息,请参阅安装 VDA

  • /components component[,component]

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

    • VDA:Virtual Delivery Agent
    • PLUGINS:适用于 Windows 的 Citrix Workspace 应用程序

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

    如果忽略此选项,将仅安装 VDA(不安装 Citrix Workspace 应用程序)。

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

  • /controllerscontroller [controller]”

    可与 VDA 通信的 Controller 的 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 远程协助中启用重影功能以与 Director 结合使用。如果指定此选项,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 Supportability Tools
    • Citrix WEM Agent
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2
    • Citrix Universal Print Client

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

    即使您使用的是第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management 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 Supportability Tools
    • Citrix WEM Agent
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2
    • User personalization layer

    如果您同时指定 /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_xxxx.exe 安装程序时无效。

  • /mastermcsimage

    指定此计算机将与 Machine Creation Services 一起用作映像。此选项相当于 /masterimage

  • /masterpvsimage

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

  • /no_mediafoundation_ack

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

  • /nodesktopexperience

    增强的桌面体验功能不再可用。此选项(和策略设置)将被忽略(如果已指定)。

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

  • /noreboot

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

  • /noresume

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

  • /physicalmachine

    请将此参数与 /remotepc 一起使用以进行 RemotePC 安装。否则,在某些用户场景中,VDA 可能无法按预期运行。

  • /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 部署(单会话操作系统)或中转连接(多会话操作系统)。排除任何其他组件的安装(请参阅带 /exclude/includeadditional 选项的组件列表)。

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

    /remotepc/servervdi 选项不兼容。

  • /remove

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

  • /remove_appdisk_ack

    授权 VDA 安装程序卸载 AppDisk VDA 插件(如果已安装)。

  • /remove_pvd_ack

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

  • /removeall

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

  • /sendexperiencemetrics

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

  • /servervdi

    在受支持的 Windows 多会话计算机上安装适用于单会话操作系统的 VDA。在 Windows 多会话计算机上安装适用于多会话操作系统的 VDA 时,请忽略此选项。

    使用此选项前,请参阅服务器 VDI

    此选项仅用于完整产品 VDA 安装程序。

  • /site_guid guid

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

  • /tempdir directory

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

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

  • /virtualmachine

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

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

  • /wem_add_firewall_rules

    添加 WEM 代理防火墙规则。

  • /wem_agent_cache_location

    备用 WEM 代理缓存位置。

  • /wem_agent_port

    WEM 代理用于与 WEM 基础结构服务器进行通信的端口。

  • /wem_cached_data_sync_port

    WEM 代理用于将缓存与 WEM 基础结构服务器同步的端口。

  • /wem_cloud_connectors

    包含 WEM 部署的资源位置中以逗号分隔的 Citrix Cloud Connector 列表。

  • /wem_server

    WEM 基础结构服务器的 FQDN 或 IP 地址。

  • /xendesktopcloud

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

VDA 安装示例

使用完整产品安装程序安装 VDA:

以下命令将在 VM 上的默认位置安装适用于单会话操作系统的 VDA 和 Citrix Workspace 应用程序。此 VDA 将用作映像,并使用 MCS 预配 VM。VDA 最初与 Controller 一起在 mydomain 域中名为 Contr-Main 的服务器上注册。VDA 将使用用户个性化层和 Windows 远程协助。

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

使用 VDAWorkstationCoreSetup 独立安装程序安装单会话操作系统 VDA:

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

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

自定义 VDA

安装 VDA 后,可以自定义多项设置。从产品介质上的 \x64\XenDesktop Setup 目录,使用用于安装 VDA 的命令行选项中介绍的下列一个或多个选项,运行 XenDesktopVdaSetup.exe 命令。

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

VDA 故障排除

  • 在交付组的 Studio 显示屏幕中,详细信息窗格中的已安装的 VDA 版本条目可能不是计算机上安装的版本。计算机的 Windows“程序和功能”将显示实际的 VDA 会话。

  • 安装 VDA 后,在向 Delivery Controller 注册之前,无法将应用程序或桌面交付给用户。

    要了解有关 VDA 注册方法以及如何解决注册问题的信息,请参阅 VDA 注册

用于安装通用打印服务器的命令行选项

以下选项对 XenDesktopPrintServerSetup.exe 命令有效。

  • /enable_upsserver_port
软件 文件夹 文件名
Microsoft Visual C++ 2017 Runtime(32 位和 64 位) 支持 > VcRedist_2017 vcredist_x64.exevcredist_x86.exe
Citrix 诊断工具 x64 > 虚拟桌面组件 cdf_x64.msi
“通用打印服务器”服务器组件 x64 > 通用打印服务器 UpsServer_x64.msi

如果未指定此选项,安装程序将从图形界面显示防火墙页面。选择自动让安装程序自动添加 Windows 防火墙规则,或者选择手动让管理员手动配置防火墙。

在打印服务器上安装该软件后,请按照预配打印机中的指导配置通用打印服务器。

更多信息

有关 Citrix 如何报告组件安装结果的信息,请参阅 Citrix 安装返回代码