Product Documentation

使用命令行安装

Jun 08, 2017

Important

请务必下载并使用 7.14.1 XenApp 和 XenDesktop ISO 和 VDA。(文件名包含版本号。)请勿使用原始 7.14 版。

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

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

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

使用完整产品安装程序

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

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

要安装核心组件,请执行以下操作:

运行 XenDesktopServerSetup.exe 命令,并使用安装核心组件的命令行选项中列出的选项。

要安装 VDA,请执行以下操作:

运行 XenDesktopVDASetup.exe 命令,并使用安装 VDA 的命令行选项中列出的选项。

要安装通用打印服务器,请执行以下操作:

请按照使用命令行安装通用打印服务器中的指导进行操作。

要安装联合身份验证服务,请执行以下操作:

Citrix 建议使用图形界面。

要安装自助式密码重置服务,请执行以下操作:

请按照自助服务密码重置服务文档中的指导进行操作。

使用独立的 VDA 安装程序

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

  • 从 Citrix 下载合适的软件包:

下载页面上的组件名称

安装程序文件名

Server OS Virtual Delivery Agent <version>

VDAServerSetup.exe

Desktop OS Virtual Delivery Agent <version>

VDAWorkstationSetup.exe

Desktop OS Core Services Virtual Delivery Agent <version>

VDAWorkstationCoreSetup.exe

  • 首先将软件包中的文件提取到一个现有目录,然后运行安装命令,或者只是运行该软件包。

要在安装之前提取文件,请使用 /extract 和绝对路径,例如:.\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia。(该目录必须存在。否则,提取将失败。然后,在独立的命令行中,运行包含所提取内容的目录(在上例中为 CitrixVDAInstallMedia)中的 XenDesktopVdaSetup.exe。请使用用于安装 VDA 的命令行选项中的有效选项。

要运行下载的软件包,请仅运行其名称:VDAServerSetup.exeVDAWorkstationSetup.exeVDAWorkstationCoreSetup.exe。请使用用于安装 VDA 的命令行选项中的有效选项。

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

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

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

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

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

/components <组件>[,<组件>] ...

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

CONTROLLER:Controller

DESKTOPSTUDIO:Studio

DESKTOPDIRECTOR:Director

LICENSESERVER:Citrix 许可证服务器

STOREFRONT:StoreFront

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

/configure_firewall

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

/disableexperiencemetrics

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

排除

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

“本地主机缓存存储(LocalDB)”:防止安装用于本地主机缓存的数据库。此选项对是否安装 SQL Server Express 以用作站点数据库没有任何影响。

“Smart Tools Agent”:防止安装 Citrix Smart Tools Agent。

/help 或 /h

显示命令帮助。

/installdir <directory>

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

/logpath <path>

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

/no_remote_assistance

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

/noreboot

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

/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

安装 XenApp。如果忽略此选项,则安装 XenDesktop。

示例:安装核心组件

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

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

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

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

用于安装 VDA 的命令行选项

以下选项在以下一个或多个命令中有效:XenDesktopVDASetup.exeVDAServerSetup.exeVDAWorkstationSetup.exeVDAWorkstationCoreSetup.exe

/baseimage

仅当在 VM 上安装 VDA for Desktop OS 时有效。为主映像启用个人虚拟磁盘。有关详细信息,请参阅 Personal vDisk

此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。

/components <component>[,<component>]

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

VDA:Virtual Delivery Agent

插件:Citrix Receiver for Windows (CitrixReceiver.exe)

例如,要安装 VDA,但不安装 Citrix Receiver,请指定 /components vda。

如果忽略此选项,将安装所有组件。

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

/controllers "<controller> [<controller>] [...]"

可与 VDA 通信的 Controller 的 FQDN,以空格分隔并用引号括起来。请勿同时指定 /site_guid 和 /controllers 选项。

/disableexperiencemetrics

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

/enable_framehawk_port

打开 Framehawk 所使用的 UDP 端口。默认值:False

/enable_hdx_3d_pro

以 HDX 3D Pro 模式安装 VDA。

/enable_hdx_ports

如果检测到 Windows 防火墙服务,即使防火墙未启用,也会在 Windows 防火墙中打开 Controller 和启用的功能(Windows 远程协助除外)所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口

提示:要打开 HDX 自适应传输功能用于与 Controller 通信的 UDP 端口,除 /enable_hdx_ports 选项外,还请指定 /enable_hdx_udp_ports 选项。

/enable_hdx_udp_ports

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

提示:要打开 VDA 用于与 Controller 和已启用的功能通信的其他端口,除 /enable_hdx_udp_ports 选项外,还请指定 /enable_hdx_ports 选项。

/enable_real_time_transport

为音频数据包(实时音频传输)启用或禁用 UDP。启用该功能可提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口,请包含 /enable_hdx_ports 选项。

/enable_remote_assistance

启用与 Director 结合使用的 Windows 远程协助中的阴影操作功能。如果指定此选项,Windows 远程协助将在防火墙中打开动态端口。

/exclude "<component>"[,"<component>"]

阻止安装一个或多个逗号分隔的可选组件,可选组件由引号引起。例如,在不受 MCS 管理的映像上安装或升级 VDA 不需要 Personal vDisk 或 Machine Identity Service 组件。有效值为:

Personal vDisk

Machine Identity Service

Citrix User Profile Manager

Citrix User Profile Manager WMI 插件

Citrix 通用打印客户端

Citrix Telemetry Service

Citrix Personalization for App-V - VDA

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

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

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

/h 或 /help

显示命令帮助。

/hdxflashv2only

阻止安装 Flash 重定向旧版二进制文件以增强安全性。

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

/installdir <directory>

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

/logpath <path>

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

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

/masterimage

仅当在 VM 上安装 VDA 时有效。将 VDA 设置为主映像。

此选项在使用 VDAWorkstationCoreSetup.exe 安装程序时无效。

/nocitrixwddm

仅在不包含 WDDM 驱动程序的 Windows 7 计算机上有效。禁用 Citrix WDDM 驱动程序的安装。

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

/nodesktopexperience

(仅在安装 VDA for Server OS 时有效。)阻止启用 Enhanced Desktop Experience 功能。此功能还受 Enhanced Desktop Experience Citrix 策略设置的控制。

/noreboot

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

/optimize

仅当在 VM 上安装 VDA 时有效。启用对虚拟机管理程序上 VM 中运行的 VDA 进行优化。VM 优化包括禁用脱机文件、禁用后台碎片整理,以及降低事件日志大小。请勿为 Remote PC Access 部署指定此选项。有关详细信息,请参阅 CTX125874

/portnumber <port>

仅当指定 /reconfig 选项时有效。用于在 VDA 和 Controller 之间进行通信的端口号。先前配置的端口如果不是 80,则会被禁用。

/quiet 或 /passive

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

/reconfig

与 /portnumber、/controllers 或 /enable_hdx_ports 选项结合使用时,自定义先前配置的 VDA 设置。如果指定此选项时未指定 /quiet 选项,将启动用于自定义 VDA 的图形界面。

/remotepc

仅适用于 Remote PC Access 部署。不在桌面操作系统中安装以下组件:

Citrix Personalization for App-V

Citrix User Profile Manager

Citrix User Profile Manager WMI 插件

Machine Identity Service

Personal vDisk

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

/remove

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

/removeall

删除已安装的所有 VDA 组件。

/sendexperiencemetrics

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

/servervdi

在支持的 Windows Server 上安装 VDA for Desktop OS。在Windows Server 上安装 VDA for Server OS 时,请忽略此选项。使用此选项前,请参阅服务器 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 信息将其显示为物理机。

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

示例:安装 VDA

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

以下命令将在 VM 的默认位置安装 VDA for Desktop OS 和 Citrix Receiver。此 VDA 将用作主映像。VDA 将首先注册到域 mydomain 中名为 Contr-Main 的服务器上的 Controller。VDA 将使用个人虚拟磁盘、优化功能以及 Windows 远程协助。

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance

使用 VDAWorkstationCoreSetup 独立安装程序安装桌面操作系统 VDA:

以下命令在桌面操作系统上安装 Core Services VDA,以用于 Remote PC Access 或 VDI 部署。不安装 Citrix Receiver 和其他非核心服务。将会指定 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 端口
  • /enable_hdx_ports

使用命令行安装通用打印服务器

在各个打印服务器上运行下列其中一个命令:

  • 在支持的 32 位操作系统中:从 Citrix 安装介质上的 \x86\Universal Print Server\ 目录中,运行 UpsServer_x86.msi
  • 在支持的 64 位操作系统中:从 Citrix 安装介质上的 \x64\Universal Print Server\ 目录中,运行 UpsServer_x64.msi

在打印服务器上安装通用打印服务器组件后,请按照置备打印机中的指南进行配置。