-
-
-
使用命令行安装 VDA
-
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
使用命令行安装 VDA
简介
本文适用于在使用 Windows 操作系统的计算机上安装、升级和自定义 Virtual Delivery Agent (VDA)。
本文介绍如何发出 VDA 安装命令。开始安装之前,请查看安装 VDA 以了解与安装注意事项、安装程序以及您在安装过程中指定的内容有关的信息。
从命令行安装 VDA
要安装 VDA(并查看命令执行进度和返回值),必须具有更高的管理权限或使用以管理员身份运行。
- 在要安装 VDA 的计算机上,登录 Citrix Cloud。
- 在左上角的菜单中,选择我的服务 > DaaS。
- 在右上角,单击 Downloads(下载)并选择 Download VDA(下载 VDA)。您被重定向到 VDA 下载页面。找到所需的 VDA 安装程序,然后单击“下载文件”。
-
下载完成后,运行其名称。请使用本文中介绍的选项。
-
对于多会话操作系统 Virtual Delivery Agent,请运行
VDAServerSetup.exe
-
对于单会话操作系统 Virtual Delivery Agent,请运行
VDAWorkstationSetup.exe
-
对于单会话操作系统核心服务 Virtual Delivery Agent,请运行
VDAWorkstationCoreSetup.exe
-
要在安装之前提取文件,请使用 /extract
和绝对路径,例如 .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia
。(该目录必须存在。否则,提取将失败。)然后在单独的命令中,使用本文中列出的有效选项运行相应的命令。
-
对于
VDAServerSetup_XXXX.exe
,请运行<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
-
对于
VDAWorkstationCoreSetup_XXXX.exe
,请运行<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe
-
对于
VDAWorkstationSetup_XXXX.exe
,请运行<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
用于安装 VDA 的命令行选项
以下选项在一个或多个命令中有效:VDAServerSetup.exe
、VDAWorkstationSetup.exe
和 VDAWorkstationCoreSetup.exe
。
-
/components component[,component]
要安装或删除的组件的列表(以逗号分隔)。有效值为:
-
VDA: Virtual Delivery Agent
-
插件: 适用于 Windows 的 Citrix Workspace 应用程序
要安装 VDA 和 Citrix Workspace 应用程序,请指定
/components vda,plugins
。如果省略
plugins
选项,则仅安装 VDA(不安装 Citrix Workspace 应用程序)。此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。该安装程序不能安装 Citrix Workspace 应用程序。 -
-
/controllers “controller [*controller*]…”
可与 VDA 通信的 Citrix Cloud Connector 的 FQDN,以空格分隔并用直引号引起。请勿同时指定
/site_guid
和/controllers
选项。 -
/disableexperiencemetrics
防止将安装、升级或删除过程中收集的分析自动上载到 Citrix。
-
/enable_hdx_ports
如果检测到 Windows 防火墙服务,即使防火墙未启用,也会在 Windows 防火墙中打开 VDA 和启用的功能(Windows 远程协助除外)所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 HDX 自适应传输功能使用的 UDP 端口,除
/enable_hdx_ports
选项外,还请指定/enable_hdx_udp_ports
选项。 -
/enable_hdx_udp_ports
如果检测到 Windows 防火墙服务,即使未启用防火墙,也请在 Windows 防火墙中打开 HDX 自适应传输功能需要的 UDP 端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 VDA 使用的端口,除
/enable_hdx_udp_ports
选项外,还请指定/enable_hdx_ports
选项。 -
/enable_real_time_transport
为音频数据包(实时音频传输)启用或禁用 UDP。启用该功能可提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口,请包含
/enable_hdx_ports
选项。 -
/enable_remote_assistance
在 Windows 远程协助中启用重影功能以与监视功能结合使用。如果指定此选项,Windows 远程协助将在防火墙中打开动态端口。
-
/enablerestore 或 /enablerestorecleanup
(仅对单会话 VDA 有效)启用在 VDA 安装或升级失败时自动返回到还原点。
如果安装/升级成功完成:
-
/enablerestorecleanup
指示安装程序删除还原点。 -
/enablerestore
指示安装程序保留还原点,即使还原点未使用。
有关详细信息,请参阅安装或升级失败时还原。
-
-
/enable_ss_ports
如果检测到 Windows 防火墙服务,即使未启用防火墙,也请在 Windows 防火墙中打开屏幕共享所需的端口。如果使用其他防火墙或未使用防火墙,则必须手动配置防火墙。
-
/exclude “component”[,”component”]
阻止安装一个或多个逗号分隔的可选组件,其中每个组件两边用直引号引起。例如,在 MCS 托管的映像上安装或升级 VDA 需要 Machine Identity Service 组件。有效值为:
- Machine Identity Service
- Citrix Profile Management
- Citrix Profile Management WMI 插件
- Citrix Personalization for App-V - VDA
- Citrix Supportability Tools
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
将 Citrix Profile Management 排除在安装之外 (
/exclude "Citrix Profile Management"
) 将影响从监视选显卡对 VDA 执行的监视和故障排除操作。在用户详细信息和端点页面上,“个性化”面板和“登录持续时间”面板会出现故障。在控制板和趋势页面上,“平均登录持续时间”面板仅显示安装了 Profile Management 的计算机的数据。即使您使用的是第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。不需要启用 Citrix Profile Management Service。
如果您计划使用 MCS 预配 VM,请勿排除 Machine Identity Service。
如果您使用相同的组件名称同时指定
/exclude
和/includeadditional
,则不会安装该组件。此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。该安装程序会自动排除这些项目中的很多项。 -
/h 或 /help
显示命令帮助。
-
/includeadditional “component”[,”component”] …
包括安装一个或多个逗号分隔的可选组件,其中每个组件两边用直引号引起。组件名称区分大小写。
创建 Remote PC Access 部署并要安装默认情况下不包含的组件时,此选项很有用。有效值为:
- Citrix Profile Management
- Citrix Profile Management WMI 插件
- Citrix Personalization for App-V - VDA
- Citrix Supportability Tools
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- 用户个性化层
- Citrix Web Socket VDA 注册工具
如果您使用相同的组件名称同时指定
/exclude
和/includeadditional
,则不会安装该组件。 -
/installdir directory
用于安装组件的现有空目录。默认为 c:\Program Files\Citrix。
-
/install_mcsio_driver
请勿使用。相反,请使用
/includeadditional "Citrix MCS IODriver"
或/exclude "Citrix MCS IODriver"
-
/logpath path
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认路径为 %TEMP%\Citrix\XenDesktop Installer
此选项在图形界面中不可用。
-
/masterimage
仅当在 VM 上安装 VDA 时有效。将 VDA 设置为映像。此选项相当于
/mastermcsimage
。此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。 -
/mastermcsimage
指定此计算机将与 Machine Creation Services 一起用作映像。此选项相当于
/masterimage
。 -
/masterpvsimage
指定此计算机将作为映像与 Citrix Provisioning 或第三方预配工具(例如 Microsoft System Center Configuration Manager)结合使用。
-
/no_mediafoundation_ack
确认不安装 Microsoft 媒体基础,并且多项 HDX 多媒体功能将不安装并且无法运行。如果忽略此操作,并且不安装媒体基础,VDA 安装将失败。大多数受支持的 Windows 版本都已附带安装 Microsoft 媒体基础,但 N 版本例外。
-
/nodesktopexperience
仅在安装多会话操作系统 VDA 时有效。阻止启用增强的桌面体验功能。此功能还受增强的桌面体验 Citrix 策略设置的控制。
-
/noreboot
防止在安装完成后重新启动。重新启动后,才能使用 VDA。
-
/noresume
默认情况下,当安装过程中需要计算机重新启动时,安装程序将在重新启动完成后自动继续运行。要覆盖默认值,请指定
/noresume
。如果在自动安装过程中必须重新装载介质或者要捕获信息,这将非常有用。 -
/portnumber port
仅当指定
/reconfig
选项时有效。用于在 VDA 和 Controller 之间进行通信的端口号。先前配置的端口如果不是 80,则会被禁用。 -
/proxyconfig“地址或 PAC 文件路径”
仅当命令包含
/includeadditional "Citrix Rendezvous V2"
时才有效。与 Rendezvous 协议一起使用的代理的地址或 PAC 文件路径。有关功能详细信息,请参阅 Rendezvous 协议。- 代理地址格式:
http://<url-or-ip>:<port>
- PAC 文件格式:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- 代理地址格式:
-
/quiet 或 /passive
安装过程中不显示任何用户界面。只能在 Windows 任务管理器中找到安装和配置过程的证据。如果忽略此选项,将启动图形界面。
-
/reconfigure
与
/portnumber
、/controllers
或/enable_hdx_ports
选项结合使用时,自定义先前配置的 VDA 设置。如果指定此选项时未指定/quiet
选项,将启动用于自定义 VDA 的图形界面。 -
/remotepc
仅适用于 Remote PC Access 部署(单会话操作系统)或中转连接(多会话操作系统)。
此选项在使用
VDAWorkstationCoreSetup.exe
安装程序时无效。该安装程序会自动排除这些组件的安装。 -
/remove_appdisk_ack
授权 VDA 安装程序卸载 AppDisk VDA 插件(如果已安装)。
-
/remove_pvd_ack
授权 VDA 安装程序卸载 Personal vDisk(如果已安装)。
-
/remove
删除通过
/components
选项指定的组件。 -
/removeall
删除 VDA。它不会删除 Citrix Workspace 应用程序(如果已安装)。
-
/sendexperiencemetrics
将安装、升级或删除过程中收集的分析自动发送到 Citrix。如果忽略此选项(或指定了
/disableexperiencemetrics
选项),分析会在本地收集,但不会自动发送。 -
/servervdi
在受支持的 Windows 服务器上安装单会话操作系统 VDA。在 Windows 服务器上安装多会话 VDA 时,请忽略此选项。使用此选项前,请参阅服务器 VDI。
-
/site_guid guid
站点 Active Directory 组织单位 (OU) 的全局唯一标识符。使用 Active Directory 进行发现时,该标识符可将虚拟桌面与站点相关联(建议和默认的发现方法为自动更新)。站点 GUID 是 Studio 中显示的站点属性。请勿同时指定
/site_guid
和/controllers
选项。 -
/tempdir directory
安装过程中用于保存临时文件的目录。默认路径为:c:\Windows\Temp。
此选项在图形界面中不可用。
-
/virtualmachine
仅当在 VM 上安装 VDA 时有效。通过物理机的安装程序覆盖检测功能,在安装程序中,传递给 VM 的 BIOS 信息将其显示为物理机。
此选项在图形界面中不可用。
-
/xendesktopcloud
表示 VDA 已安装在 Citrix DaaS (Citrix Cloud) 部署中。
示例:安装 VDA
-
在多会话操作系统上安装 VDA。以下命令将在多会话操作系统中安装 VDA。
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage
VDA 将用作映像。
-
安装多会话操作系统 VDA 或单会话操作系统 VDA。以下命令安装多会话操作系统 VDA 或单会话操作系统 VDA。
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot
用逗号分隔每个 Delivery Controller FQDN。请注意,
XXXX
代表 VDA 版本。 -
在单会话操作系统上安装核心服务 VDA。以下命令在单个会话操作系统上安装核心服务 VDA,用于 Remote PC Access 或 VDA 部署。
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
不安装 Citrix Workspace 应用程序和其他非核心服务。指定了 Cloud Connector 的地址,并自动打开 Windows 防火墙服务中的端口。管理员负责处理重新启动。
使用命令行自定义 VDA
安装 VDA 后,可以自定义多项设置。使用下面的一个或多个选项运行 XenDesktopVDASetup.exe
。
-
/reconfigure
(自定义 VDA 时需要) -
/h
或/help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports
下一步的去向
共享
共享
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.