-
-
-
使用命令行安装 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。
- 在右上角,单击下载并选择下载 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
-
PLUGINS: Citrix Workspace™ app for Windows
要安装 VDA 和 Citrix Workspace app,请指定
/components vda,plugins
。如果省略
plugins
选项,则仅安装 VDA(不安装 Citrix Workspace app)。使用
VDAWorkstationCoreSetup.exe
安装程序时,此选项无效。该安装程序无法安装 Citrix Workspace app。 -
-
/controllers “controller [controller]…”
Citrix Cloud Connector 的 FQDN(完全限定域名)列表,以空格分隔,VDA 可与其通信,并用直引号引起来。请勿同时指定
/site_guid
和/controllers
选项。 -
/disableexperiencemetrics
阻止将安装、升级或删除过程中收集的分析数据自动上传到 Citrix。
-
/enable_hdx_ports
如果检测到 Windows 防火墙服务,则打开 VDA 和已启用功能(Windows 远程协助除外)所需的 Windows 防火墙中的端口,即使防火墙未启用也是如此。如果您使用的是其他防火墙或没有防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 HDX 自适应传输所需的 UDP 端口,除了
/enable_hdx_ports
选项之外,还要指定/enable_hdx_udp_ports
选项。 -
/enable_hdx_udp_ports
如果检测到 Windows 防火墙服务,则打开 HDX 自适应传输所需的 Windows 防火墙中的 UDP 端口,即使防火墙未启用也是如此。如果您使用的是其他防火墙或没有防火墙,则必须手动配置防火墙。有关端口信息,请参阅网络端口。
要打开 VDA 使用的端口,除了
/enable_hdx_udp_ports
选项之外,还要指定/enable_hdx_ports
选项。 -
/enable_real_time_transport
启用或禁用将 UDP 用于音频数据包(用于音频的 RealTime Audio Transport)。启用此功能可以提高音频性能。如果希望在检测到 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 Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
从安装中排除 Citrix Profile Management (
/exclude "Citrix Profile Management"
) 会影响从监视器控制台对 VDA 进行监视和故障排除。在用户详细信息和 EndPoint 页面上,“个性化”面板和“登录持续时间”面板将失败。在控制板和趋势页面上,“平均登录持续时间”面板仅显示已安装 Profile Management 的计算机的数据。即使您使用的是第三方 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 Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- User personalization layer
- Citrix Web Socket VDA Registration Tool
如果同时指定
/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 Media Foundation,并且未安装多个 HDX™ 多媒体功能且无法正常工作。如果省略此选项且未安装 Media Foundation,则 VDA 安装将失败。大多数受支持的 Windows 版本都已安装 Media Foundation,N 版本除外。
-
/nodesktopexperience
仅在安装多会话操作系统 VDA 时有效。阻止启用增强桌面体验功能。此功能也由增强桌面体验 Citrix 策略设置控制。
-
/noreboot
阻止安装后重新启动。VDA 必须在重新启动后才能使用。
-
/noresume
默认情况下,如果在安装过程中需要重新启动计算机,安装程序将在重新启动完成后自动恢复。要覆盖默认设置,请指定
/noresume
。如果您必须重新装载介质或希望在自动安装期间捕获信息,此功能会很有用。 -
/portnumber port
仅在指定
/reconfig
选项时有效。用于启用 VDA 与 Controller 之间通信的端口号。除非是端口 80,否则以前配置的端口将被禁用。 -
/proxyconfig “address or PAC file path”
仅当命令包含
/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 安装程序卸载 AppDisks™ VDA 插件(如果已安装)。
-
/remove_pvd_ack
授权 VDA 安装程序卸载 Personal vDisk(如果已安装)。
-
/remove
删除使用
/components
选项指定的组件。 -
/removeall
删除 VDA。它不会删除 Citrix Workspace app(如果已安装)。
-
/sendexperiencemetrics
自动将安装、升级或删除过程中收集的分析数据发送到 Citrix。如果省略此选项(或指定
/disableexperiencemetrics
选项),则分析数据将在本地收集,但不会自动发送。 -
/servervdi
在受支持的 Windows 服务器上安装单会话操作系统 VDA。在 Windows 服务器上安装多会话 VDA 时,请省略此选项。在使用此选项之前,请参阅 Server 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 app 和其他非核心服务。指定 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.