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 中的指导进行操作。

    要安装 Workspace Environment Management,请执行以下操作: 请按照 Workspace Environment Management 中的指导进行操作。

使用独立的 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 安装程序不同,因为它支持可用于其他安装程序的一部分选项。

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

使用 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_pending_reboot_check

    安装或升级核心组件时,请阻止检查计算机上以前的 Windows 安装中挂起的重新启动。

  • /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 的命令行选项

以下选项在以下一个或多个命令(安装程序)中有效: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 组件。有效值如下所示:

    多会话操作系统 单会话操作系统 单会话操作系统核心服务
    Citrix Authentication Identity Assertion VDA Plug-in Citrix Authentication Identity Assertion VDA Plug-in Citrix Authentication Identity Assertion VDA Plug-in
    Citrix Backup and Restore Citrix Backup and Restore Citrix Browser Content Redirection
    Citrix Browser Content Redirection Citrix Browser Content Redirection Citrix Personalization for App-V - VDA
    Citrix MCS IODriver Citrix MCS IODriver Citrix Telemetry Service
    Citrix Personalization for App-V - VDA Citrix Personalization for App-V - VDA Citrix Universal Print Client
    Citrix Profile Management Citrix Profile Management Citrix Vda Log Capture Service
    Citrix Profile Management WMI Plug-in Citrix Profile Management WMI Plug-in CSE Component
    Citrix Rendezvous V2 Citrix Rendezvous V2 Director VDA Plug-in
    Citrix Telemetry Service Citrix Telemetry Service Machine Management Provider
    Citrix Universal Print Client Citrix Universal Print Client VDA Monitor Plug-in
    Citrix Vda Log Capture Service Citrix Vda Log Capture Service VDA WMI Proxy Plug-in
    Citrix VDA Upgrade Agent Citrix VDA Upgrade Agent  
    CSE Component CSE Component  
    Director VDA Plug-in Director VDA Plug-in  
    Machine Identity Service Machine Identity Service  
    Machine Management Provider Machine Management Provider  
    VDA Monitor Plug-in User Personalization Layer  
    VDA WMI Proxy Plug-in VDA Monitor Plug-in  
      VDA WMI Proxy Plug-in  

    将 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 Backup and Restore Citrix Backup and Restore
    Citrix MCS IODriver Citrix MCS IODriver
    Citrix Personalization for App-V - VDA Citrix Personalization for App-V - VDA
    Citrix Profile Management Citrix Profile Management
    Citrix Profile Management WMI Plug-in Citrix Profile Management WMI Plug-in
    Citrix Rendezvous V2 Citrix Rendezvous V2
    Citrix VDA Upgrade Agent Citrix VDA Upgrade Agent
    Citrix Web Socket Vda Registration Tool Citrix Web Socket Vda Registration Tool
    Machine Identity Service Machine Identity Service
      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 信息将其显示为物理机。

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

  • /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 安装返回代码