Product Documentation

使用命令行安装

May 12, 2016

注意:本文适用于在使用 Windows 操作系统的计算机上安装组件。 有关适用于 Linux 操作系统的 VDA 的信息,请参阅 Red Hat Linux VDASUSE Linux VDA

在本文中: 

简介

重要:开始执行任何安装之前,请查看准备安装一文,文章介绍了安装程序以及您应在安装之前熟悉的任何内容。 该文章还将介绍命令随附的选项。 本文介绍了如何启动产品安装程序中的命令行界面。

可以使用命令行界面执行以下操作:

  • 安装一个或多个核心组件:Delivery Controller、Citrix Studio、Citrix Director、许可证服务器和 StoreFront。
  • 在主映像、虚拟机或物理机上安装 Virtual Delivery Agent (VDA)。 还可以对介质上提供的脚本进行自定义,然后使用这些脚本在 Active Directory 中安装和删除 VDA。
  • 自定义先前安装的 VDA。
  • 安装通用打印服务器,用于置备网络会话打印机。 Controller 已具备通用打印服务器功能;您只需在环境中的打印服务器上安装通用打印服务器。
  • 升级组件;请参阅升级部署一文。

还可以使用 /remove 或 /removeall 选项从以前安装的此版本中删除组件。 有关详细信息,请参阅删除组件一文。

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

完整产品安装程序和独立的 VDA 安装程序都有命令行界面。

如果使用提供的示例脚本在 Active Directory 中安装、升级或删除 VDA 计算机,可以指定 VDA 配置选项,这些选项在下面用于安装 VDA 部分的命令行选项中列出。 有关示例脚本的信息,请参阅使用脚本安装 VDA 一文。

使用完整产品安装程序

可以使用完整产品安装程序安装核心组件和 VDA。

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

要安装核心组件,请运行 XenDesktopServerSetup.exe 命令。 请使用下文用于安装核心组件的命令行选项部分中列出的选项。

要安装 VDA,请运行 XenDesktopVDASetup.exe 命令。 请使用下文用于安装 VDA 的命令行选项部分中列出的选项。

使用完整产品安装程序安装核心组件的示例

示例 1:以下命令将在服务器上安装 XenDesktop 控制器、Studio、Citrix Licensing 和 SQL Server Express。 将自动打开组件通信所需的端口。

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

示例 2:以下命令将在服务器上安装 XenApp 控制器、Studio 和 SQL Server Express。 将自动打开组件通信所需的端口。

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

使用完整产品安装程序安装 VDA 的示例

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

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

示例 2:以下命令将在办公室 PC 上的默认位置安装 VDA for Windows Desktop OS 和 Citrix Receiver,该 PC 将与 Remote PC Access 结合使用。 安装 VDA 后不会重新启动计算机;但是,必须重新启动才能使用 VDA。 VDA 将首先注册到域 mydomain 中名为 Contr-East 的服务器上的 Controller,并将对音频数据包使用 UDP。 如果检测到 Windows 防火墙服务,将会打开 HDX 端口。

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-East.mydomain.local" /enable_hdx_ports /enable_real_time_transport /noreboot 

使用独立的 VDA 安装程序

重要:准备安装一文提供与您在安装过程中看到和指定的信息有关的指南,特别是与使用独立的 VDA 安装程序时处理重新启动和提取空间有关的指南。

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

  1. 从 Citrix 下载适用的软件包:VDAServerSetup.exe(适用于服务器操作系统计算机)或 VDAWorkstationSetup.exe(适用于桌面操作系统计算机)。 对于单用户、单服务器操作系统部署(例如,将 Windows Server 2012 交付给一个用户,用于进行 Web 开发),请使用 VDAWorkstationSetup.exe 软件包。 有关详细信息,请参阅服务器 VDI 一文。
  2. 首先提取软件包中的文件,然后运行安装命令,或者只是运行该软件包。

要在安装之前提取文件,请使用 /extract 和绝对路径,例如:.\VDAWorkstationSetup.exe /extract %temp%\CitrixVDAInstallMedia。 然后,在独立的命令行中运行包含所提取内容的目录(在上例中为 CitrixVDAInstallMedia)中的 XenDesktopVdaSetup.exe 命令。 请使用下文用于安装 VDA 的命令行选项部分中列出的选项。

要仅运行下载的软件包,请运行其名称:VDAServerSetup.exeVDAWorkstationSetup.exe。 请使用下文用于安装 VDA 的命令行选项部分中列出的选项。 (如果您熟悉完整产品安装程序:运行下载的独立软件包,就像该软件包是任何安装程序中的 XenDesktop VdaSetup.exe 命令一样,名称除外。)

使用独立的 VDA 安装程序安装 VDA 的示例

以下安装命令通常用于 Remote PC Access。 该命令将在物理办公室 PC 上安装 VDA,但不安装 Citrix Receiver 或 Citrix Profile Manager。 安装 VDA 后不会自动重新启动计算机;但是,必须重新启动计算机才能使用 VDA。 VDA 最初与 Controller 一起在名为 Contr-East 的服务器上注册。 如果检测到 Windows 防火墙服务,则会打开端口。

VDAWorkstationSetup.exe /quiet /components vda /exclude "Citrix User Profile Manager" /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

注意

从安装中排除 Citrix User Profile Manager 将影响对带有 Citrix Director 的 VDA 进行监视和故障排除。 在“用户详细信息”和“端点”页面上,“个性化”面板和“登录持续时间”面板将出现故障。 在“控制板”和“趋势”页面上,“平均登录时间”面板将仅显示安装了 Profile Management 的计算机的数据。

使用命令行自定义 VDA

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

  • /reconfigure - 自定义 VDA 时,必须使用此选项
  • /h 或 /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber 端口
  • /enable_hdx_ports

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

下表列出了 XenDesktopServerSetup.exe 命令的有效选项。

选项

说明

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

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

  • CONTROLLER – Controller
  • DESKTOPSTUDIO – Studio
  • DESKTOPDIRECTOR – Director
  • LICENSESERVER - Citrix 许可证服务器
  • STOREFRONT – StoreFront

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

/configure_firewall

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

/help 或 /h

显示命令帮助。

/installdir 目录

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

/logpath 路径

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

/no_remote_assistance

(仅当安装 Director 时有效。)禁用使用 Windows 远程协助的用户阴影操作功能。

/noreboot

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

/nosql

阻止在即将安装 Controller 的服务器上安装 Microsoft SQL Server Express。 如果忽略此选项,则将安装 SQL Server Express。

/quiet 或 /passive

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

/remove

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

/removeall

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

/tempdir 目录

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

/xenapp

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

用于安装 VDA 的命令行选项

下表列出了 XenDesktopVDASetup.exe 命令的有效选项。

安装与 Remote PC Access 结合使用的 VDA 时,请仅指定在物理机(而非 VM 或主映像)上有效的选项以及适用于 VDA for Windows Desktop OS 的选项。

除非另有说明,否则这些选项将应用于物理机和虚拟机,以及 VDA for Windows Desktop OS 和 VDA for Windows Server OS。

选项

说明

/baseimage

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

/components component[,component]

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

  • VDA - 安装 VDA
  • PLUGINS - 安装 Citrix Receiver for Windows (CitrixReceiver.exe)

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

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

/controllers "controller [controller] [...]"

可与 VDA 通信的 Controller 的完全限定的域名 (FQDN),以空格分隔并用引号引起。 请勿同时指定 /site_guid 和 /controllers 选项。

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

/enable_hdx_3d_pro

安装 VDA for HDX 3D Pro。 有关详细信息,请参阅 HDX 3D Pro 一文。

/enable_hdx_ports

如果检测到 Windows 防火墙服务,即使防火墙未启用,也会在 Windows 防火墙中打开 Controller 和指定功能(Windows 远程协助、实时传输和优化)所需的端口。 如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。

/enable_real_time_transport

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

/enable_remote_assistance

启用与 Director 结合使用的 Windows 远程协助中的阴影操作功能。 如果指定此选项,Windows 将在防火墙中打开 TCP 端口 3389,即使忽略了 /enable_hdx_ports 选项也是如此。

/exclude "component"[,"component"]

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

  • Personal vDisk
  • Machine Identity Service
  • Citrix User Profile Manager

从 VDA 安装中排除 Citrix User Profile Manager 将影响对带有 Citrix Director 的 VDA 进行监视和故障排除。 在“用户详细信息”和“端点”页面上,“个性化”面板和“登录持续时间”面板将出现故障。 在“控制板”和“趋势”页面上,“平均登录时间”面板将仅显示安装了 Profile Management 的计算机的数据。

/h 或 /help

显示命令帮助。

/installdir 目录

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

/installwithsecurebootenabled

启用安全引导时允许安装 VDA。 如果忽略此选项,则将显示“必须禁用安全引导才能成功安装 VDA”的警告。  (此选项在图形界面中不可用。)

/logpath 路径

日志文件位置。 指定的文件夹必须已存在;安装程序无法创建该文件夹。  (此选项在图形界面中不可用。)默认路径为:%TEMP%\Citrix\XenDesktop Installer

/masterimage

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

/no_appv阻止安装 Citrix App-V 组件。 有关详细信息,请参阅 App-V 一文。 

/nocitrixwddm

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

/nodesktopexperience

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

/noreboot

防止在安装完成后重新启动。 只有在重新启动后,才能使用 VDA 的全部功能。

/optimize

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

/portnumber 端口

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

/quiet 或 /passive

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

/reconfig

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

/remotepc

阻止在桌面(工作站)操作系统中安装以下组件:

  • App V 组件 - Citrix Personalization for App-V - VDA
  • Upm 组件 - Citrix User Profile Manager
  • UpmVdaPlugin 组件 - Citrix User Profile Manager WMI Plugin
  • Mps 组件 - Machine Identity Service
  • 虚拟磁盘组件 - Personal vDisk

升级过程中,如果安装了上述任意组件,安装程序都会检测该组件并进行更新。

/remove

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

/removeall

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

/servervdi

在支持的 Windows Server 上安装 VDA for Windows Desktop OS。 在Windows Server 上安装 VDA for Windows Server OS 时,请忽略此选项。 使用此选项之前,请参阅服务器 VDI 一文。 (此选项在图形界面中不可用。)

/site_guid guid

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

/tempdir 目录

安装过程中用于保存临时文件的目录。 (此选项在图形界面中不可用。)默认路径为:c:\Windows\Temp。

/virtualmachine

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

/xa_server_location url

Windows 服务器应用程序的服务器的 URL。

 

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

注意:如果要在 32 位 Windows 2008 服务器上安装 UpsServer 组件,请先阅读本文

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

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

Citrix 建议您将设置为 1 的命令行选项 /ENABLE_CEIP 包括在内,以选择加入 Citrix 客户体验改善计划 (CEIP)。 例如:

msiexec /i UpsServer.msi ENABLE_CEIP=1

选择加入后,系统会将匿名统计数据和使用信息发送到 Citrix 以帮助改善 Citrix 产品的质量和性能。

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

在 32 位 Windows 2008 服务器上安装通用打印服务器之前的准备工作

在 32 位 Windows 2008 计算机上部署 UpsServer_x86.msi 之前,必须使用 Visual Basic 脚本或 Orca 等工具调整 cdf_x86.msi 和 UpsServer_x86.msi 的 Windows Installer 的最低版本。

  1. 将 CDF 和 UPS msi 文件的 32 位版本(cdf_x86.msiUpsServer_x86.msi)复制到某个临时文件夹。
  2. 安装 WiSumInf.vbs 脚本或 Orca 工具,两者均可在 Windows SDK Components for Windows Installer Developers 软件包中获取。 有关脚本的信息,请参阅 MSDN 文章 Manage Summary Information(管理摘要信息)。
  3. 可以使用下面方法之一修改 Windows Installer 的最低版本:

使用 WiSumInf.vbs 脚本:将 WiSumInf.vbs 复制到两个 Citrix msi 所在的相同临时文件夹。 然后,使用 WiSumInf.vbs cdf_x86.msi Pages=405WiSumInf.vbs UpsServer_x86.msi Pages=405 运行每个软件包的脚本。

使用 Orca:分别打开 cdf_x86.msi 和 UpsServer_x86.msi 软件包,转至“View”(查看)菜单 >“Summary Information”(摘要信息),将 Schema(架构)文本框的值更改为 405

完成上述过程后,在打印服务器上安装通用打印服务器。