使用命令行安装
本文适用于在使用 窗户操作系统的计算机上安装组件。有关适用于 Linux操作系统的 VDA的信息,请参阅Linux虚拟交付代理文档。
重要:
本文介绍如何发出产品安装命令。在开始进行任何安装之前,请查看准备安装。这篇文章提供了可用安装程序的说明。
要查看命令的执行进度和返回值,您必须是原始管理员或者使用以管理员身份运行。有关详细信息,请参阅微软命令文档。
作为对直接使用安装命令的补充,产品 国际标准化组织中提供了示例脚本,它们用于在 活动目录中安装、升级或删除 VDA计算机。有关详细信息,请参阅使用脚本安装的共识。
使用完整产品安装程序
要访问完整产品安装程序的命令行接口,请执行以下操作:
- 请从Citrix下载产品软件包。需要提供Citrix帐户凭据才能访问下载站点。
- 解压文件。或者刻录 ISO 文件的 DVD。
- 通过本地管理员帐户,登录要在其中安装组件的服务器。
- 在驱动器中插入 数字化视频光盘或装载 国际标准化组织文件。
- 从介质上的
\ x64 \ XenDesktop设置
目录中,运行相应的命令。
安装核心组件
运行XenDesktopServerSetup.exe
命令,并使用安装核心组件的命令行选项中列出的选项。
安装 VDA
运行XenDesktopVDASetup.exe
命令,并使用安装 VDA的命令行选项中列出的选项。
安装通用打印服务器
按照使用命令行安装通用打印服务器中的指导进行操作。
安装联合身份验证服务
Citrix建议使用图形界面。
安装自助服务密码重置服务
请按照自助服务密码重置服务文档中的指导进行操作。
使用独立的VDA安装程序
需要提供Citrix帐户凭据才能访问下载站点。必须在开始安装之前提升管理权限,或使用以管理员身份运行。
- 从 Citrix下载合适的软件包:
下载页面上的组件名称 | 安装程序文件名 |
---|---|
服务器操作系统虚拟投递代理<版本> | VDAServerSetup.exe |
桌面操作系统 虚拟交付代理<版本> | VDAWorkstationSetup.exe |
桌面操作系统核心服务虚拟投递代理<版本> | VDAWorkstationResetUp.exe |
- 首先将软件包中的文件提取到一个现有目录,然后运行安装命令,或者只是运行该软件包。
要在安装之前提取文件,请使用/提取
和绝对路径,例如\vdaWorkstationResetUp.exe/extract%temp%\CitrixVDAInstallMedia
。(该目录必须存在。否则,提取将失败。)然后,在单独的命令中,从包含所提取内容的目录(在上例中为CitrixVDAInstallMedia
)运行XenDesktopVdaSetup.exe
。请使用用于安装 VDA的命令行选项中的有效选项。
要运行下载的软件包,只需运行其名称:VDAServerSetup.exe
、VDAWorkstationSetup.exe
或VDAWorkstationResetUp.exe
。请使用用于安装 VDA的命令行选项中的有效选项。
如果您熟悉完整产品安装程序:
请运行独立的
VDAServerSetup.exe
或VDAWorkstationSetup.exe
安装程序,就像它是XenDesktopVdaSetup.exe
命令一样,除了名称不同。VDAWorkstationResetUp.exe
安装程序不同,因为它支持可用于其他安装程序的一部分选项。
用于安装核心组件的命令行选项
使用XenDesktopServerSetup.exe
命令安装核心组件时,以下选项有效。有关选项的更多详细信息,请参阅安装核心组件。
/组成部分<组件> [,<组件>)……
要安装或删除的组件的列表(以逗号分隔)。有效值为:
控制器
:控制器
DESKTOPSTUDIO
:工作室
桌面控制器
董事:
LICENSESERVER
: Citrix许可证服务器
如果忽略此选项,将安装所有组件(如果还指定了/除去
选项,则删除所有组件)。
(在 7.15 LTSR CU6之前的版本中,有效值包括 店面对于版本 7.15 LTSR CU6及更高版本,请使用安装 店面中所述的专用店面安装命令)。
/配置防火墙
如果 窗户防火墙服务正在运行,即使该防火墙并未启用,也会在 窗户防火墙中打开正在安装的组件使用的所有端口。如果您使用的是第三方防火墙或未使用防火墙,则必须手动打开这些端口。
/ disableexperiencemetrics
防止将安装、升级或删除过程中收集的分析自动上载到 Citrix
排除
阻止安装一个或多个逗号分隔的功能、服务或技术,两边用直引号括起来。有效值为:
本地主机缓存存储(LocalDB)
:防止安装用于本地主机缓存的数据库。此选项对是否安装 SQL Server Express以用作站点数据库没有任何影响。
智能工具代理
代理:防止安装Citrix智能工具。
注意:
自 CU4起,智能工具不再包含在安装程序中。早期安装中存在的 智能工具实例保持不变。
帮助或/ h
显示命令帮助。
/installdir<目录>
用于安装组件的现有空目录。默认值 =c:\Program Files\Citrix
。
/日志路径<路径>
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 =%TEMP%\Citrix\XenDesktop安装程序
/ no_remote_assistance
仅当安装时主任有效。禁用可使用Windows远程协助的用户重影功能。
/诺雷博特
防止在安装完成后重新启动。(对于大多数核心组件,默认情况下不启用重新启动。)
/nosql
阻止在即将安装 控制器的服务器上安装 Microsoft SQL Server Express如果忽略此选项,将安装 SQL Server Express以用作站点数据库。(此选项对安装用于本地主机缓存的 SQL Server Express LocalDB没有任何影响。)
/安静的或被动的
安装过程中不显示任何用户界面。而只能在Windows任务管理器中找到安装过程的证据。如果忽略此选项,将启动图形界面。
/除去
删除通过/组成部分
选项指定的核心组件。
/移除
删除已安装的所有核心组件。
/经验计量学
将安装,升级或删除过程中收集的分析自动发送到Citrix。如果忽略此选项(或指定了/ disableexperiencemetrics
),分析会在本地收集,但不会自动发送。
/坦普迪尔<目录>
安装过程中用于保存临时文件的目录。默认路径为:c:\Windows\Temp
/ xenapp
安装 塞纳普如果忽略此选项,则安装 XenDesktop
示例:安装核心组件
以下命令将在服务器上安装 XenDesktop控制器、工作室、Citrix授权和 SQLServerExpress组件通信所需的防火墙端口会自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall . x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
以下命令将在服务器上安装XenApp控制器,工作室和SQL Server Express。组件通信所需的防火墙端口会自动打开。
\x64\XenDesktop设置\XenDesktopServerSetup.exe/xenapp/components controller,desktopstudio/configure\u防火墙
用于安装 VDA的命令行选项
以下选项在以下一个或多个命令中有效:XenDesktopVDASetup.exe
、VDAServerSetup.exe
、VDAWorkstationSetup.exe
或VDAWorkstationResetUp.exe
。
/ baseimage
仅当在VM上安装VDA桌面操作系统时的有效。为主映像启用个人虚拟磁盘。有关详细信息,请参阅个人虚拟磁盘。
此选项在使用VDAWorkstationResetUp.exe
安装程序时无效。
/组成部分<组件>[,<组件>]
要安装或删除的组件的列表(以逗号分隔)。有效值为:
VDA
:虚拟交付代理
插件
:用于Windows的Citrix接收器(CitrixReceiver.exe
)
例如,要安装 VDA但不安装 Citrix接收器请指定/组件的共识
。
如果忽略此选项,将安装所有组件。
此选项在使用VDAWorkstationResetUp.exe
安装程序时无效。该安装程序不能安装 Citrix接收器
/控制器“<控制器> [<控制器>] […]”
可与VDA通信的控制器的FQDN,以空格分隔并用直引号括起来。请勿同时指定/ site_guid
和/控制器
选项。
/ disableexperiencemetrics
防止将安装、升级或删除过程中收集的分析自动上载到 Citrix
/ enable_framehawk_port
打开 框架鹰所使用的 UDP端口。默认值:错误的
/ enable_hdx_3d_pro
以HDX 3 d专业模式安装的共识。
/启用\u hdx\u端口
如果检测到 窗户防火墙服务,即使防火墙未启用,也会在 窗户防火墙中打开 VDA和启用的功能(窗户远程协助除外)所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开HDX自适应传输功能使用的UDP端口,请指定/启用\u hdx\u udp\u端口
选项和/启用\u hdx\u端口
选项。
/启用\u hdx\u udp\u端口
如果检测到 窗户防火墙服务,即使未启用防火墙,也请在 窗户防火墙中打开 HDX自适应传输功能所需的 UDP端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 VDA使用的其他端口,请指定/启用\u hdx\u端口
选项和/启用\u hdx\u udp\u端口
选项。
/ enable_real_time_transport
为音频数据包(实时音频传输)启用或禁用UDP。启用该功能可提高音频性能。如果希望在检测到Windows防火墙服务时自动打开UDP端口,请包含/启用\u hdx\u端口
选项。
/启用远程协助
在 窗户远程协助中启用重影功能以与 经理结合使用。如果指定此选项,窗户远程协助将在防火墙中打开动态端口。
/排除" <组件>,“(<组件>”)
阻止安装一个或多个逗号分隔的可选组件,两边用直引号括起来。例如,在不受 MCS管理的映像上安装或升级 VDA不需要 个人虚拟磁盘或 机器识别服务组件。有效值为:
个人虚拟磁盘
机器识别服务
Citrix用户配置文件管理器
Citrix用户配置文件管理器WMI插件
Citrix通用打印客户端
Citrix遥测技术服务
适用于App-V的Citrix个性化-VDA
将Citrix概要管理排除在安装(使用/不包括“Citrix用户档案管理器”
选之项)外将影响通过Citrix导演对VDA执行的监视和故障排除操作。在用户详细信息和端点页面上,个性化面板和登录持续时间面板会出现故障。在控制板和趋势页面上,平均登录持续时间面板仅显示安装了 档案管理的计算机的数据。
即使您使用的是第三方用户配置文件管理解决方案,Citrix仍建议您安装并运行 Citrix配置文件管理服务不需要启用 Citrix配置文件管理服务
此选项在使用VDAWorkstationResetUp.exe
安装程序时无效。该安装程序会自动排除这些项目中的很多项。
/h或 /帮助
显示命令帮助。
/仅HDxFlashV2O
阻止安装Flash重定向旧版二进制文件以增强安全性。
此选项在图形界面中不可用。
/installdir<目录>
用于安装组件的现有空目录。默认值 =c:\Program Files\Citrix
。
/日志路径<路径>
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 =%TEMP%\Citrix\XenDesktop安装程序
此选项在图形界面中不可用。
/主图像
仅当在 虚拟机上安装 VDA时有效。将 VDA设置为主映像。
此选项在使用VDAWorkstationResetUp.exe
安装程序时无效。
/无媒体基础确认
确认不安装微软媒体基础,并且多项HDX多媒体功能将不安装并且无法运行。如果忽略此操作,并且不安装媒体基础,VDA安装将失败。大多数受支持的Windows版本都已附带安装微软媒体基础,但N版本例外。
/ nocitrixwddm
仅在不包含 波分复用驱动程序的 视窗7计算机上有效。禁用 Citrix WDDM驱动程序的安装。
此选项在图形界面中不可用。
/节点操作经验
(仅在安装VDA为服务器操作系统时有效)阻止启用增强的桌面体验功能。此功能还受增强的桌面体验Citrix策略设置的控制。
/诺雷博特
防止在安装完成后重新启动。重新启动后,才能使用 VDA
/ noresume
默认情况下,当安装过程中需要计算机重新启动时,安装程序将在重新启动完成后自动继续运行。要覆盖默认值,请指定/ noresume
。如果在自动安装过程中必须重新装载介质或者要捕获信息,这将非常有用。
/优化
仅当在VM上安装VDA时有效。启用对虚拟机管理程序上的VM中运行的VDA进行优化。VM优化包括禁用脱机文件,禁用后台碎片整理,以及降低事件日志大小。请勿为远程PC访问部署指定此选项。有关更多信息,请参阅CTX224676。
/ portnumber <端口>
仅当指定/ reconfig
选项时有效。用于在 VDA和 控制器之间进行通信的端口号。先前配置的端口如果不是 80,则会被禁用。
/安静的或被动的
安装过程中不显示任何用户界面。只能在Windows任务管理器中找到安装和配置过程的证据。如果忽略此选项,将启动图形界面。
/重新配置
与/ portnumber
、/控制器
或/启用\u hdx\u端口
选项结合使用时,自定义先前配置的 VDA设置。如果指定此选项时未指定/安静的
选项,将启动用于自定义VDA的图形界面。
/ remotepc
仅适用于 远程PC访问部署。不在桌面操作系统中安装以下组件:
- 适用于App-V的Citrix个性化
- Citrix用户配置文件管理器
- Citrix用户配置文件管理器WMI插件
- 机器识别服务
- 个人虚拟磁盘
此选项在使用VDAWorkstationResetUp.exe
安装程序时无效。该安装程序会自动排除这些组件的安装。
/除去
删除通过/组成部分
选项指定的组件。
/移除
删除已安装的所有两组件。
/经验计量学
将安装,升级或删除过程中收集的分析自动发送到Citrix。如果忽略此选项(或指定了/ disableexperiencemetrics
选项),分析会在本地收集,但不会自动发送。
/服务器VDI
在支持的Windows服务器上安装VDA桌面操作系统。在Windows 服务器上安装 VDA for Server OS 时,请忽略此选项。使用此选项前,请参阅服务器 VDI。
此选项仅用于完整产品 VDA安装程序。此选项在图形界面中不可用。
/站点guid<指南>
站点 活动目录组织单位 (其他指定用途)的全局唯一标识符。使用 活动目录进行发现时,该标识符可将虚拟桌面与站点相关联(建议和默认的发现方法为自动更新)。站点 指南是 演播室中显示的站点属性。请勿同时指定/ site_guid
和/控制器
选项。
/坦普迪尔<目录>
安装过程中用于保存临时文件的目录。默认值 =c:\Windows\Temp
。
此选项在图形界面中不可用。
/虚拟机
仅当在 虚拟机上安装 VDA时有效。通过物理机的安装程序覆盖检测功能,在安装程序中,传递给 虚拟机的 基本输入/输出系统信息将其显示为物理机。
此选项在图形界面中不可用。
示例:安装 VDA
使用完整产品安装程序安装 VDA
以下命令将在 虚拟机的默认位置安装 用于桌面操作系统的VDA和 Citrix接收器此 VDA将用作主映像。VDA将首先注册到域 mydomain中名为 控制总管的服务器上的 控制器.VDA将使用个人虚拟磁盘、优化功能以及 窗户远程协助。
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe/quiet/components vda,插件/控制器“Contr Main.mydomain.local”/enable\u hdx\u port/optimize/masterimage/baseimage/enable\u remote\u assistance
使用VDAWorkstationCoreSetup独立安装程序安装桌面操作系统的共识
以下命令在桌面操作系统上安装 核心服务VDA以用于 远程PC访问或 VDI部署。不安装 Citrix接收器和其他非核心服务。将会指定 控制器的地址,且 窗户防火墙服务中的端口将自动打开。管理员将处理重新启动。
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot .exe /quiet /controllers
使用命令行自定义 VDA
安装的共识后,可以自定义多项设置。从产品介质上的\ x64 \ XenDesktop设置
目录,使用用于安装 VDA的命令行选项中介绍的下列一个或多个选项,运行XenDesktopVdaSetup.exe
命令。
/重新配置
(自定义 VDA时需要)/h
或/帮助
/安静的
/诺雷博特
/控制器
/ portnumber
端口/启用\u hdx\u端口
使用命令行安装通用打印服务器
在各个打印服务器上运行下列其中一个命令:
- 在支持的32位操作系统上:从Citrix安装介质上的
\x86\通用打印服务器\
目录运行UpsServer_x86.msi
。 - 在支持的 64位操作系统中:从 Citrix安装介质上的
\x64\通用打印服务器\
目录运行UpsServer_x64.msi
。
在打印服务器上安装通用打印服务器组件后,请按照预配打印机中的指导对其进行配置。