使用命令行安装vda
简介
本文适用于在Windows操作系统的机器上安装、升级和定制虚拟交付代理(Virtual Delivery agent, vda)。
本文描述如何发出VDA安装命令。在开始安装之前,请检查安装的共识了解安装注意事项、安装程序以及在安装期间指定的内容。
从命令行安装VDA
要安装VDA(并查看命令执行进度和返回值),您必须具有较高的管理权限或使用权限以管理员身份运行.
- 在安装VDA的机器上,登录到Citrix云.
- 在左上菜单中,选择My Services > DaaS.
- 2 .单击右上角的下载并选择下载的共识.你被重定向到VDA下载页面.找到所需的VDA安装程序并单击下载文件.
下载完成后,运行它的名称。使用本文中描述的选项。
对于多会话操作系统Virtual Delivery Agent,执行
VDAServerSetup.exe
对于单会话操作系统Virtual Delivery Agent,执行
VDAWorkstationSetup.exe
对于单会话的OS Core Services Virtual Delivery Agent,执行
VDAWorkstationCoreSetup.exe
要在安装之前解压缩文件,请使用/提取
例如,使用绝对路径.\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia .exe
.(该目录必须存在。否则,提取将失败。)然后在单独的命令中,使用本文列出的有效选项运行适当的命令。
为
VDAServerSetup_XXXX.exe
、运行\ extract \Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe 为
VDAWorkstationCoreSetup_XXXX.exe
、运行\ extract \Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe 为
VDAWorkstationSetup_XXXX.exe
、运行\ extract \Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
命令行选项用于安装VDA
以下选项对一个或多个命令有效:VDAServerSetup.exe
,VDAWorkstationSetup.exe
,VDAWorkstationCoreSetup.exe
.
/组件组件(,组件]
要安装或删除的组件列表,以逗号分隔。有效值为:
的共识:虚拟送货代理
插件:思杰工作空间应用程序的Windows
要安装VDA和Citrix Workspace应用程序,请指定
/组件的共识,插件
.如果
插件
选项被省略,只安装VDA(而不是Citrix Workspace应用程序)。属性时,此选项无效
VDAWorkstationCoreSetup.exe
安装程序。该安装程序无法安装Citrix Workspace应用程序。/控制器”控制器[控制器)……”
用空格分隔的Citrix云连接器的fqdn, VDA可以与之通信,用直引号括起来。不要同时指定
/ site_guid
而且/控制器
选项。/ disableexperiencemetrics
防止在安装、升级或移除Citrix期间自动上传收集的分析。
/ enable_hdx_ports
如果检测到Windows防火墙服务,即使防火墙未启用,也会打开VDA所需的Windows防火墙端口和已启用的功能(Windows Remote Assistance除外)。如果您使用不同的防火墙或没有防火墙,则必须手动配置防火墙。有关端口信息,请参见网络端口.
要打开HDX自适应传输的UDP端口,请指定
/ enable_hdx_udp_ports
选项,除了/ enable_hdx_ports
选择。/ enable_hdx_udp_ports
如果检测到Windows防火墙服务,即使防火墙未启用,也会打开HDX自适应传输所需的Windows防火墙中的UDP端口。如果您使用不同的防火墙或没有防火墙,则必须手动配置防火墙。有关端口信息,请参见网络端口.
要打开VDA使用的端口,请指定
/ enable_hdx_ports
选项,除了/ enable_hdx_udp_ports
选择。/ enable_real_time_transport
启用或禁用对音频包使用UDP(音频的实时音频传输)。启用此功能可以提高音频性能。包括
/ enable_hdx_ports
选项,如果您想在检测到Windows防火墙服务时自动打开UDP端口。/ enable_remote_assistance
控件中启用Windows远程帮助中的阴影功能监控功能。如果指定此选项,Windows远程协助将在防火墙中打开动态端口。
/ enablerestore或/ enablerestorecleanup
(仅对单会话VDA有效)当VDA安装或升级失败时,自动返回到还原点。
如果安装/升级成功:
/ enablerestorecleanup
指示安装程序删除还原点。/ enablerestore
指示安装程序保留还原点,即使没有使用该还原点。
详细信息请参见在安装或升级失败时恢复.
/ enable_ss_ports
如果检测到Windows防火墙服务,即使防火墙未启用,也会在Windows防火墙中打开屏幕共享所需的端口。如果您使用不同的防火墙或没有防火墙,则必须手动配置防火墙。
/排除”组件“,”组件”)
防止安装一个或多个用逗号分隔的可选组件,每个组件都用直引号括起来。例如,在mcs管理的映像上安装或升级VDA需要使用机器标识服务组件。有效值为:
- 机器识别服务
- Citrix配置文件管理
- Citrix配置文件管理WMI插件
- Citrix个性化应用程序- v - VDA
- Citrix支持工具
- Citrix MCS IODriver
- Citrix VDA升级代理
- Citrix Rendezvous V2
从安装中排除Citrix配置文件管理(
/排除“Citrix配置文件管理”
)影响vda的监控和故障排除监控选项卡。在用户详细信息而且端点页面、“个性化”面板和“登录持续时间”面板失败。在指示板而且趋势页中,“平均登录持续时间”面板仅显示安装了配置文件管理的计算机的数据。即使您使用第三方配置文件管理解决方案,Citrix也建议您安装并运行Citrix配置文件管理服务。不需要启用Citrix Profile Management Service。
如果使用MCS发放虚拟机,请不要排除机器识别服务。
如果同时指定
/排除
而且/ includeadditional
如果组件名称相同,则不会安装该组件。属性时,此选项无效
VDAWorkstationCoreSetup.exe
安装程序。安装程序会自动排除其中的许多项。/小时或/帮助
显示命令帮助。
/ includeadditional”组件“,”组件“)…
包括一个或多个用逗号分隔的可选组件的安装,每个组件都用直引号括起来。组件名称区分大小写。
当您正在创建Remote PC Access部署,并且希望安装默认情况下未包含的组件时,此选项可能很有帮助。有效值为:
- Citrix配置文件管理
- Citrix配置文件管理WMI插件
- Citrix个性化应用程序- v - VDA
- Citrix支持工具
- Citrix MCS IODriver
- Citrix VDA升级代理
- Citrix Rendezvous V2
- 用户个性化层
- Citrix Web Socket VDA注册工具
如果同时指定
/排除
而且/ includeadditional
如果使用相同的组件名称,则不会安装该组件。/ installdir目录
将在其中安装组件的现有空目录。默认值= c:\Program Files\Citrix.
/ install_mcsio_driver
不要使用。相反,使用
/include额外的“Citrix MCS IODriver”
或/排除“Citrix MCS IODriver”
/ logpath路径
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认= " %TEMP%\Citrix\XenDesktop Installer "
此选项在图形界面中不可用。
/ masterimage
仅当在虚拟机上安装VDA时有效。将VDA设置为映像。此选项相当于
/ mastermcsimage
.属性时,此选项无效
VDAWorkstationCoreSetup.exe
安装程序。/ mastermcsimage
指定此机器将在“机器创建服务”中用作映像。此选项相当于
/ masterimage
./ masterpvsimage
指定此计算机将作为Citrix Provisioning或第三方Provisioning工具(如Microsoft System Center Configuration Manager)的映像使用。
/ no_mediafoundation_ack
确认未安装Microsoft Media Foundation,若干HDX多媒体功能未安装且无法工作。如果省略该选项,且未安装Media Foundation,则VDA安装失败。除N个版本外,大多数受支持的Windows版本都已安装Media Foundation。
/ nodesktopexperience
仅在安装多会话操作系统VDA时有效。阻止启用“增强的桌面体验”功能。该特性还可以通过Enhanced Desktop Experience Citrix策略设置进行控制。
/ noreboot
防止安装后重新启动。VDA重启后才能使用。
/ noresume
默认情况下,当安装过程中需要重新启动计算机时,安装程序将在重新启动完成后自动恢复。要覆盖默认值,请指定
/ noresume
.如果必须重新挂载媒体或希望在自动安装期间捕获信息,这可能很有帮助。/ portnumber港口
仅当
/ reconfig
选项。用于VDA和控制器之间通信的端口号。先前配置的端口被禁用,除非它是端口80。/ proxyconfig”地址或PAC文件路径”
仅当命令包含
/ incldeextra“Citrix Rendezvous V2”
.用于集合协议的代理的地址或PAC文件路径。有关特性的详细信息,请参见对接协议.- 代理地址格式:
http:// < url-or-ip >: <口>
- PAC文件格式:
http:// < url-or-ip >: <口> / <路径> / <文件名> .pac
- 代理地址格式:
/安静或/被动
安装过程中不会出现任何用户界面。安装和配置过程的唯一证据是在Windows任务管理器中。如果省略此选项,则启动图形界面。
/重新配置
控件一起使用时,自定义以前配置的VDA设置
/ portnumber
,/控制器
,或/ enable_hdx_ports
选项。如果指定此选项而不指定/安静
选项,用于自定义VDA启动的图形界面。/ remotepc
仅对远程PC访问部署(单会话操作系统)或代理连接(多会话操作系统)有效。
属性时,此选项无效
VDAWorkstationCoreSetup.exe
安装程序。该安装程序自动排除这些组件的安装。/ remove_appdisk_ack
授权VDA安装程序卸载已安装的AppDisks VDA插件。
/ remove_pvd_ack
授权VDA安装程序卸载个人vDisk(如果已安装)。
/删除
属性指定的组件
/组件
选择。/ removeall
移除VDA。它不会删除Citrix Workspace应用程序(如果已安装)。
/ sendexperiencemetrics
自动将在安装、升级或删除期间收集的分析发送到Citrix。如果省略此选项(或
/ disableexperiencemetrics
选项),分析将在本地收集,但不会自动发送。/ servervdi
在受支持的Windows服务器上安装单会话操作系统VDA。在Windows服务器上安装多会话VDA时,请忽略此选项。在使用此选项之前,请参见服务器VDI.
/ site_guidguid
站点OU (Active Directory organization Unit)的全局唯一标识。这将在您使用Active Directory进行发现时将虚拟桌面与站点关联(自动更新是推荐的和默认的发现方法)。站点GUID是中显示的站点属性管理>满配.不要同时指定
/ site_guid
而且/控制器
选项。/ tempdir目录
目录,用于在安装期间保存临时文件。默认值= c:\Windows\Temp.
此选项在图形界面中不可用。
/ virtualmachine
仅当在虚拟机上安装VDA时有效。覆盖物理机安装程序的检测,其中传递给vm的BIOS信息使它们显示为物理机。
此选项在图形界面中不可用。
/ xendesktopcloud
表示VDA安装在Citrix DaaS (Citrix Cloud)部署中。
示例:安装VDA
以下命令在多会话操作系统上安装VDA。VDA将用作映像。
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage .exe
以下命令在单会话操作系统上安装Core Services VDA,用于远程PC访问或VDI部署。未安装Citrix Workspace app等非核心服务。指定云连接器的地址后,Windows防火墙服务中的端口将自动打开。管理员处理重启。
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
使用命令行定制VDA
安装VDA后,可以自定义一些设置。运行XenDesktopVDASetup.exe
,使用以下一个或多个选项。
/重新配置
(自定义VDA时需要)/小时
或/帮助
/安静
/ noreboot
/控制器
/ portnumber港口
/ enable_hdx_ports