Product Documentation

使用命令行安装

Nov 06, 2015
使用命令行界面可执行以下操作:
  • 安装一个或多个核心组件:Delivery Controller、Citrix Studio、Citrix Director、许可证服务器和 StoreFront。
  • 在主映像、虚拟机或物理机上安装 Virtual Delivery Agent (VDA)。

    还可以对介质上提供的脚本进行自定义,然后使用这些脚本在 Active Directory 中安装和删除 VDA;请参阅使用脚本在 Active Directory 中安装或删除 Virtual Delivery Agent

  • 自定义先前安装的 VDA。
  • 安装通用打印服务器,用于置备网络会话打印机。(Controller 已具备通用打印服务器功能;您只需在环境中的打印服务器上安装通用打印服务器。)

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

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

重要:开始安装之前,请阅读并完成准备安装中的任务。

使用命令行安装核心组件

从介质上的 \x64\XenDesktop Setup 目录,运行 XenDesktopServerSetup.exe 命令。下表介绍了相关命令选项。
选项 说明

/help 或 /h

显示命令帮助。

/quiet

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

/logpath 路径

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

/noreboot

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

/remove

删除通过 /components 选项指定的核心组件。有关删除组件的详细信息,请参阅删除组件

/removeall

删除已安装的所有核心组件。有关删除组件的详细信息,请参阅删除组件

/configure_firewall

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

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

(必需。)要安装或删除的组件的列表(以逗号分隔)。有效值为:
  • CONTROLLER - Controller
  • DESKTOPSTUDIO - Studio
  • DESKTOPDIRECTOR - Director
  • LICENSESERVER - Citrix Licensing
  • STOREFRONT - StoreFront

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

/installdir 目录

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

/tempdir 目录

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

/nosql

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

/enableremoteassistance

(仅当安装 Director 时有效。)启用 Windows 远程协助功能。安装 Director 时,始终将安装 Windows 远程协助,可以通过在命令行中包含或忽略此选项来启用或禁用此功能。

例如,使用以下命令可在服务器上安装 Controller、Studio、Citrix Licensing 和 SQL Server Express。将自动在 Windows 防火墙中打开 Controller 和许可证服务器通信所需的端口。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

使用命令行安装 VDA

注意:有关在 Windows XP 或 Windows Vista 系统上安装 Virtual Desktop Agent 早期版本的信息,请参阅在 Windows XP 或 Windows Vista 上安装早期的 Virtual Desktop Agent

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

从产品介质上的 \x64\XenDesktop Setup 目录,运行 XenDesktopVdaSetup.exe 命令。下表介绍了相关命令选项。除非另有说明,否则这些选项将应用于物理机和虚拟机,以及 VDA for Windows Desktop OS 和 VDA for Windows Server OS。
选项 说明

/h 或 /help

显示命令帮助。

/quiet

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

/logpath 路径

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

/noreboot

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

/remove

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

/removeall

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

/reconfig

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

/portnumber 端口

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

/components component[,component]

要安装或删除的组件的列表(以逗号分隔)。有效值为:
  • VDA - 安装 VDA
  • PLUGINS - 安装 Citrix Receiver for Windows (CitrixReceiver.exe)

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

/installdir 目录

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

/tempdir 目录

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

/site_guid guid

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

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

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

/xa_server_location url

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

/enable_remote_assistance

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

/enable_hdx_ports

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

/optimize

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

/baseimage

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

/enable_hdx_3d_pro

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

/enable_real_time_transport

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

/masterimage

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

/isvirtual

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

/nodesktopexperience

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

/nocitrixwddm

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

/servervdi

在支持的 Windows Server 上安装 VDA for Windows Desktop OS。在Windows Server 上安装 VDA for Windows Server OS 时,请忽略此选项。使用此选项前,请参阅服务器 VDI

/installwithsecurebootenabled

启用安全引导时允许安装 VDA。如果忽略此选项,将显示“必须禁用安全引导才能成功安装 VDA”的警告。

以下命令将在 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
以下命令将在办公室 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 后,可以自定义多项设置。从产品介质上的 \x64\XenDesktop Setup 目录,使用前文介绍过的下列一个或多个选项,运行 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