使用命令行安装
重要的是:
如果您正在升级,并且您当前的版本使用或安装了Personal VDisk或AppDisks软件,请参阅删除pvd,appdisks和不支持的主机.
介绍
本文适用于在具有Windows操作系统的机器上安装组件。Linux操作系统vda的相关信息请参见Linux虚拟交付代理.
本文介绍如何发出产品安装命令。在开始任何安装之前,检查准备安装.这篇文章包括对可用安装程序的描述。
要查看命令执行进度和返回值,您必须是原始管理员或用户以管理员身份运行.有关更多信息,请参见Microsoft命令文档。
作为直接使用安装命令的补充,产品ISO上提供了示例脚本,用于在Active Directory中的计算机上安装、升级或删除VDA。有关详细信息,请参阅使用脚本安装VDAs.
如果您试图在本Citrix虚拟应用程序和桌面版本不支持的Windows操作系统版本上安装或升级,则会有一条消息引导您了解有关选项的信息。看到早期的操作系统.
有关Citrix如何报告组件安装结果的信息,请参见Citrix安装返回码.
使用完整产品安装程序
要访问完整的产品安装程序的命令行界面:
- 从Citrix下载产品包。访问下载站点需要Citrix帐户凭证。
- 解压文件。可选地,刻录ISO文件的DVD。
- 使用本地管理员帐户登录到正在安装组件的服务器。
- 将光盘插入光驱或挂载ISO文件。
从
\ x64 \ XenDesktop设置
在介质上的目录中,运行相应的命令。安装核心组件:运行
XenDesktopServerSetup.exe
,列出的选项用于安装核心组件的命令行选项.要安装VDA,请执行以下操作:运行
xendesktopvdasetup.exe.
中列出的选项用于安装VDA的命令行选项.安装店面:运行
CitrixStoreFront-x64.exe
在x64 >店面
安装介质上的文件夹。安装Universal Print Server:遵循指导用于安装通用打印服务器的命令行选项.
安装联邦身份验证服务:Citrix建议使用图形界面。
安装会话录音:遵循指导会议记录.
使用独立的VDA安装程序
访问下载站点需要Citrix帐户凭证。在开始安装之前,您必须具有较高的管理权限,或者使用以管理员身份运行.
- 从Citrix下载相应的软件包:
- 多项会话操作系统虚拟交付代理:
VDAServerSetup.exe
- 单会话OS虚拟交付代理:
VDAWorkstationSetup.exe
- 单会话操作系统核心服务虚拟交付代理:
VDAWorkstationResetUp.exe
- 多项会话操作系统虚拟交付代理:
要么先将包中的文件解压缩到现有目录中,然后运行安装命令,要么直接运行包。
要在安装之前提取文件,请使用
/提取
以绝对路径为例。\ VDAWorkstationCoreSetup.exe /提取%临时% \ CitrixVDAInstallMedia
.目录必须存在。否则,提取物失败。然后在单独的命令中使用本文中列出的有效选项运行相应的命令。为了
VDAServerSetup_XXXX.exe
、运行\extract\Image Full\x64\XenDesktop安装程序\XenDesktopVDASetup.exe 为了
VDAWorkstationCoreSetup_XXXX.exe
、运行< >提取文件夹\ \ Image-Full提取\ x64 \ \ XenDesktopRemotePCSetup.exe XenDesktop设置
为了
VDAWorkstationSetup_XXXX.exe
、运行\extract\Image Full\x64\XenDesktop安装程序\XenDesktopVDASetup.exe
要运行下载的包,请运行其名称:
VDAServerSetup.exe
那VDAWorkstationSetup.exe
,或VDAWorkstationResetUp.exe
.使用本文中列出的有效选项。
如果您熟悉完整的产品安装程序:
运行独立的
VDAServerSetup.exe
或VDAWorkstationSetup.exe
安装程序,就好像它是XenDesktopVdaSetup.exe
除了名字之外,其他的都是命令。这
VDAWorkstationResetUp.exe
安装程序是不同的,因为它支持其他安装程序可用选项的子集。
用于安装核心组件的命令行选项
使用安装核心组件时,以下选项有效XenDesktopServerSetup.exe
命令。有关选项的更多详细信息,请参阅安装核心组件.
/组成部分成分[,成分)……
要安装或删除的组件的逗号分隔列表。有效值为:
控制器
:控制器Desktopstudio
:工作室桌面控制器
:导演许可证
: Citrix License Server
如果省略此选项,则安装所有组件(如果
/除去
选项)。(在2003年以前的版本中,包含有效值
店面
.对于版本2003及更高版本,请使用提到的专用店面安装命令使用完整产品安装程序)./配置防火墙
如果Windows firewall Service运行,即使没有开启防火墙,也会打开所安装组件使用的Windows防火墙的所有端口。如果您正在使用第三方防火墙或没有防火墙,则必须手动打开端口。
/ disableexperiencemetrics
防止在安装,升级或拆除到Citrix期间收集的自动上传分析。
/排除“特色”[,”特色”]
防止安装一个或多个用逗号分隔的特性、服务或技术,每个特性、服务或技术都用直接的引号括起来。有效值:
“本地主机缓存存储(localDB)”
:防止安装本地主机缓存所使用的数据库。此选项对是否安装SQL Server Express作为站点数据库没有影响。
/帮助或/小时
显示命令帮助。
/ ignore_hw_check_failure
允许继续安装或升级Delivery Controller,即使硬件检查失败(例如,由于RAM不足)。有关更多信息,请参见硬件检查.
/ ignore_site_test_failure
仅在升级Controller时有效。通常,任何站点测试失败都会被忽略,升级会继续进行。如果省略(或设置为false),任何站点测试失败都会导致安装程序失败,而不执行升级。默认= false
在升级过程中,如果检测到不支持的SQL Server版本,则忽略此选项。有关详细信息,请参阅SQL Server版本检查.
/ installdir目录
将安装组件的现有空目录。默认= C:\ Program Files \ Citrix。
/ logpath.小路
日志文件的位置。指定的文件夹必须存在。安装程序不会创建它。默认=
临时% \ Citrix \ XenDesktop安装程序
/ no_pending_reboot_check
安装或升级核心组件时,防止检查计算机上以前安装的Windows是否有挂起的重新启动。
/ no_remote_assistance
仅在安装Director时有效。禁用使用Windows远程协助的用户阴影特性。
/ noreboot
防止安装后重新启动。(对于大多数核心组件,默认情况下未启用重启。)
/ noresume
默认情况下,当安装过程中需要重新启动机器时,安装程序将在重新启动完成后自动恢复。若要覆盖默认值,请指定
/ noresume
。如果您必须重新安装媒体或希望在自动安装过程中捕获信息,这将非常有用。/nosql
防止在安装控制器的服务器上安装Microsoft SQL Server Express。如果省略此选项,则安装SQL Server Express以用作站点数据库。
此选项对用于本地主机缓存的SQL Server Express LocalDB的安装没有影响。
/安静或/被动
安装过程中没有出现用户界面。安装过程的唯一证据是在Windows任务管理器中。如果省略此选项,则图形界面启动。
/除去
属性指定的核心组件
/组成部分
选项/ removeall
删除所有已安装的核心组件。
/ sendexperiencemetrics
自动将安装、升级或删除过程中收集的分析信息发送给Citrix。如果省略此选项(或
/ disableexperiencemetrics
指定),分析在本地收集,但不会自动发送。/ tempdir.目录
存放安装期间临时文件的目录。默认= c:\Windows\Temp.
/ Xenapp.
安装Citrix虚拟应用。如果省略此选项,则安装Citrix Virtual Apps和desktop。
安装核心组件的示例
下面的命令将在服务器上安装Delivery Controller、Studio、Citrix Licensing和SQL Server Express。组件通信所需的防火墙端口自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall . 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 / Companionsert,Desktopstudio / configure_firewall
用于安装VDA的命令行选项
以下选项对下列命令(安装程序)中的一个或多个是有效的:xendesktopvdasetup.exe.
那VDAWorkstationSetup.exe
,VDAWorkstationResetUp.exe
.
有关选项的更多详细信息,请参阅安装VDA..
/组成部分成分[,成分]
要安装或删除的组件的逗号分隔列表。有效值为:
VDA
:虚拟快递代理插件
:适用于Windows的Citrix工作区应用程序
要安装Windows的VDA和Citrix工作区应用程序,请指定
/组件的共识,插件
.如果省略此选项,则只安装了VDA(而不是Citrix Workspace应用程序)。
使用时,此选项无效
VDAWorkstationResetUp.exe
安装程序。安装程序无法安装Citrix工作区应用程序。/控制器“控制器[控制器]”
VDA可以与之通信的控制器的空格分隔FQDN,用直引号括起来。不要同时指定
/ site_guid.
和/控制器
选项。/ disableexperiencemetrics
防止在安装,升级或删除到Citrix期间收集的自动上传分析。
/ enable_hdx_ports
如果检测到Windows防火墙服务,即使没有启用防火墙,也会在VDA所需的Windows防火墙中打开端口,并启用特性(Windows远程协助除外)。如果您正在使用不同的防火墙或没有防火墙,则必须手动配置防火墙。端口信息请参见网络港口.
要打开HDX自适应传输使用的UDP端口,指定
/启用\u hdx\u udp\u端口
选项,除此之外/ enable_hdx_ports
选项/启用\u hdx\u udp\u端口
打开HDX自适应传输使用的Windows防火墙中的UDP端口,如果检测到Windows防火墙服务,即使防火墙没有启用。如果您正在使用不同的防火墙或没有防火墙,则必须手动配置防火墙。端口信息请参见网络港口.
要打开VDA使用的额外端口,请指定
/ enable_hdx_ports
选项,除此之外/启用\u hdx\u udp\u端口
选项/ enable_real_time_transport.
启用或禁用UDP音频包(RealTime音频传输)的使用。启用此功能可以提高音频性能。包括
/ enable_hdx_ports
选项,如果您希望在检测到Windows防火墙服务时自动打开UDP端口。/启用远程协助
启用Windows远程帮助中的阴影功能与导演一起使用。如果指定此选项,Windows远程协助将打开防火墙中的动态端口。
/启用还原或/ enablerestorecleanup
(仅对单会话VDA有效)当VDA安装或升级失败时,启用自动返回到恢复点。
如果安装/升级成功:
/ enablerestorecleanup
指示安装程序删除还原点。/启用还原
指示安装程序保留还原点,即使它没有被使用。
有关详细信息,请参阅安装或升级失败时恢复.
/排除“成分”[,”成分”]
防止安装一个或多个逗号分隔的可选组件,每个组件都用直引号括起来。例如,在不由MCS管理的映像上安装或升级VDA不需要机器标识服务组件。有效值为:
机身份服务
Citrix概要管理
Citrix简介管理WMI插件
Citrix通用打印客户端
Citrix遥测服务
适用于App-V的Citrix个性化-VDA
Citrix可支持性工具
Windows的Citrix文件
Citrix文件用于Outlook
用户个性化层
Citrix的电话代理
Citrix MCS IODriver
Citrix VDA升级代理
从安装中排除Citrix配置文件管理(
/排除“citrix档案管理”
)影响与思杰总监一起监控和排除VDAs的故障。在这一点用户详细信息和终点页面,个性化面板和登录持续时间面板失败。在这一点指示板和趋势页面,平均登录持续时间面板只显示安装了概要文件管理的计算机的数据。即使您使用的是第三方用户配置文件管理解决方案,Citrix也建议您安装并运行Citrix配置文件管理服务。不需要启用Citrix配置文件管理服务。
如果你指定两者
/排除
和/ includeadditional
如果组件名称相同,则未安装该组件。使用时,此选项无效
VDAWorkstationResetUp.exe
安装程序。该安装程序自动排除许多这些项目。/小时或/帮助
显示命令帮助。
/ includeadditional“成分”[,”成分”]
包括安装一个或多个用逗号分隔的可选组件,每个组件都用引号括起来。当您正在创建远程PC访问部署,并且希望安装默认情况下没有包含的其他组件时,此选项可能会很有帮助。有效值:
Citrix概要管理
Citrix简介管理WMI插件
Citrix通用打印客户端
Citrix遥测服务
适用于App-V的Citrix个性化-VDA
Citrix可支持性工具
Windows的Citrix文件
Citrix文件用于Outlook
用户个性化层
Citrix的电话代理
Citrix MCS IODriver
Citrix VDA升级代理
如果你指定两者
/排除
和/ includeadditional
如果组件名称相同,则未安装该组件。/ installdir目录
将安装组件的现有空目录。默认= C:\ Program Files \ Citrix。
/ install_mcsio_driver
不使用。竖起,使用
/include附加的“Citrix MCS IODriver”
或/exclude Citrix MCS IODriver"
/ logpath.小路
日志文件的位置。指定的文件夹必须存在。安装程序不会创建它。默认=“%temp%\ citrix \ xendesktop安装程序”
此选项在图形界面中不可用。
/ masterimage
仅当在虚拟机上安装VDA时有效。将VDA设置为用于创建其他机器的映像。这个选项等价于
/ mastermcsimage.
.使用时,此选项无效
VDAWorkstationResetUp.exe
安装程序。/ mastermcsimage.
指定此机器将与机器创建服务一起用作映像。这个选项等价于
/ masterimage
./ masterpvsimage
指定此机器将作为镜像与Citrix发放或第三方发放工具(如Microsoft System Center Configuration Manager)一起发放虚拟机。
/无媒体基础确认
承认没有安装微软媒体基金会,一些HDX多媒体功能将没有安装,并且无法工作。如果省略此选项,且未安装Media Foundation,则VDA安装失败。除了N个版本外,大多数受支持的Windows版本都已经安装了Media Foundation。
/ nodesktopexperience
增强的桌面体验功能不再可用。如果指定了该选项(和策略设置),则忽略该选项。
仅当为多会话操作系统安装VDA时有效。防止启用“增强桌面体验”功能。此功能还可以通过增强的桌面体验Citrix策略设置进行控制。
/ noreboot
防止安装后重新启动。VDA需要重启后才能使用。
/ noresume
默认情况下,当安装过程中需要重新启动机器时,安装程序将在重新启动完成后自动恢复。若要覆盖默认值,请指定
/ noresume
。如果您必须重新安装媒体或希望在自动安装过程中捕获信息,这将非常有用。/ portnumber港口
只有在何时有效
/重新配置
指定了选项。启用VDA和控制器之间通信的端口号。先前配置的端口被禁用,除非是端口80。/安静或/被动
安装过程中没有出现用户界面。安装和配置过程的唯一证据是在Windows任务管理器中。如果省略此选项,则图形界面启动。
/重新配置
控件使用时自定义先前配置的VDA设置
/ portnumber
那/控制器
,或/ enable_hdx_ports
选项。如果指定此选项而不同时指定/安静
选项,用于自定义VDA启动的图形界面。/ remotepc.
仅对远程PC接入部署(单会话操作系统)或代理连接(多会话操作系统)有效。不包括在单会话操作系统上安装以下组件:
- 适用于App-V的Citrix个性化
- Citrix概要管理
- Citrix配置文件管理WMI插件
- 机身份服务
- Citrix可支持性工具
- Windows的Citrix文件
- Citrix文件用于Outlook
- 用户个性化层
- Citrix的电话代理
- Citrix MCS IO写缓存用于存储优化
使用时,此选项无效
VDAWorkstationResetUp.exe
安装程序。安装程序自动排除这些组件的安装。/除去
属性指定的组件
/组成部分
选项/ remove_appdisk_ack
授权VDA安装程序卸载已安装的AppDisks VDA插件。
/ remove_pvd_ack
授权VDA安装程序卸载个人vDisk(如果它已经安装)。
/ removeall
消除了共识。它不会删除Citrix工作区应用程序(如果已安装)。
/ sendexperiencemetrics
自动将安装、升级或删除过程中收集的分析信息发送给Citrix。如果省略此选项(或
/ disableexperiencemetrics
选项),分析在本地收集,但不会自动发送。/服务器VDI
在支持的Windows多会话计算机上为单会话操作系统安装VDA。在Windows多会话机器上为多会话操作系统安装VDA时省略此选项。
在使用此选项之前,请参见服务器VDI.
仅在完整产品VDA安装程序中使用此选项。
/ site_guid.guid
全局唯一标识站点OU (Active Directory organization Unit)。当您使用Active Directory进行发现时,这会将虚拟桌面与站点关联起来(自动更新是推荐的默认发现方法)。站点GUID是在Studio中显示的站点属性。不要同时指定
/ site_guid.
和/控制器
选项。/ tempdir.目录
存放安装期间临时文件的目录。默认= c:\Windows\Temp.
此选项在图形界面中不可用。
/虚拟机
仅当在虚拟机上安装VDA时有效。覆盖物理机器的安装程序的检测,其中BIOS信息传递给vm使它们看起来像物理机器。
此选项在图形界面中不可用。
/ wem_add_firewall_rules
添加WEM代理防火墙规则。
/ wem_agent_cache_location
替代WEM代理缓存位置。
/ wem_agent_port.
WEM代理与WEM基础架构服务器通信的端口。
/ wem_cached_data_sync_port
WEM代理用于将缓存与WEM基础结构服务器同步的端口。
/ wem_cloud_connectors
包含WEM部署的资源位置中以逗号分隔的Citrix云连接器列表。
/ wem_server
WEM基础架构服务器的FQDN或IP地址。
安装VDA的示例
使用全产品安装程序安装VDA:
将单会话操作系统和Citrix Workspace应用安装到虚拟机的默认位置。该VDA作为镜像,使用MCS发放虚拟机。VDA最初将向指定服务器上的Controller注册Contr-Main
在域名mydomain
.VDA将使用用户个性化层和Windows远程协助。
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers " control - main. mydomain。本地" /enable_hdx_ports /includeadditional "用户个性化层" /mastermcsimage /enable_remote_assistance
使用VDAWorkstationCoreSetup独立安装程序安装单会话操作系统VDA:
以下命令在单会话操作系统上安装Core Services VDA,用于远程PC访问或VDI部署。未安装Citrix Workspace应用程序和其他非核心服务。指定Controller的地址后,Windows Firewall Service中的端口将自动打开。管理员将处理重启。
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot .exe /quiet /controllers
定制一个共识
安装VDA后,您可以自定义几个设置。从\ x64 \ XenDesktop设置
目录,运行XenDesktopVdaSetup.exe
,使用下列一个或多个选项,这些选项在用于安装VDA的命令行选项.
/重新配置
(定制VDA时需要)/小时
或/帮助
/安静
/ noreboot
/控制器
/端口号端口
/ enable_hdx_ports
解决的共识
在传送组的Studio显示中VDA版本安装条目的细节窗格可能不是机器上安装的版本。机器的Windows程序和功能显示实际的VDA版本。
安装VDA后,只有注册到交付控制器(Delivery Controller)后,才能向用户交付应用程序或桌面。
要了解VDA注册方法和如何排除注册问题,请参见VDA登记.
用于安装通用打印服务器的命令行选项
下面的选项对XenDesktopPrintServerSetup.exe
命令。
- / enable_upsserver_port.
软件 | 文件夹 | 文件名称 |
---|---|---|
微软Visual C++ 2017运行时32位和64位 | 支持> vcredist_2017 | vcredist_x64.exe 和vcredist_x86.exe. |
Citrix诊断设施 | x64>虚拟桌面组件 | cdf_x64.msi |
通用打印服务器服务器组件 | x64 >通用打印服务器 | UpsServer_x64.msi |
如果未指定此选项,安装程序将显示防火墙页面从图形界面。选择自动让安装程序自动添加Windows防火墙规则,或人工让管理员手动配置防火墙。
在打印服务器上安装软件后,使用指南配置通用打印服务器供应打印机.
更多信息
有关Citrix如何报告组件安装结果的信息,请参见Citrix安装返回码.