Skip to main content

2026 年 10 月 2 日

适用于 Windows 的 Horizon Agent 的无提示安装属性

从命令行中无提示安装适用于 Windows 的 Horizon Agent 时,您可以包含特定属性。您必须使用 PROPERTY=value 的格式,以便 Microsoft Windows Installer (MSI) 理解各属性和值。无提示升级使用相同的安装命令。您还可以用无提示方式修改已安装的 Horizon Agent 组件。

下表显示了您可以在命令行中使用的 Horizon Agent 无提示安装属性。

**注意:**以下步骤使用名称 agent-installer.exe 指代安装程序文件。

静默安装 Horizon Agent 的 MSI 属性

MSI 属性描述默认值
ENABLE_UNC_REDIRECTION指定是否安装了 UNC 路径重定向功能。值为 1 时安装该功能。您必须使用组策略设置配置要重定向的 UNC。请参阅《Horizon 远程桌面功能和 GPO》文档中的“配置 UNC 路径重定向”。 此 MSI 属性是可选的。0
HORIZON_MONITOR_ENABLED指定启用还是禁用 Horizon 监控模式。仅当您的环境中安装了 Horizon Cloud Service - next-gen 时,此标记才有效。 值为 1 将启用 Horizon 监控模式。值为 0 将禁用 Horizon 监控模式。0
IGNORE_DOTNET_CHECK确定安装程序是否检查最低 .NET 版本。默认情况下,选择 Horizon Performance Tracker 后,安装程序会执行预检查以确认是否安装了 .NET 4.6.2 或更高版本,如未安装,则会停止安装过程。 值为 1 时取消此预检查。值为 0 时允许继续执行预检查。0
INSTALLDIR安装 Horizon Agent 软件的路径和文件夹。例如: INSTALLDIR=""D:\abc\my folder"" 括住路径的两组双引号可允许 MSI 安装程序忽略路径中的空格。 此 MSI 属性是可选的。%ProgramFiles%\Omnissa\Horizon\Agent
RDP_CHOICE确定是否在桌面上启用远程桌面协议 (RDP)。 值为 1 时启用 RDP。值为 0 时停用 RDP 设置。 此 MSI 属性是可选的。1
SUPPRESS_RUNONCE_CHECK忽略 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce 和 RunOnceEx 注册表项中计划在下次重新引导操作系统时执行的待处理 Windows 更新任务。使用此标记可允许并行安装,但当系统更新影响 Horizon Agent 运行时依赖关系时,不能保证获得所需的安装结果。 此 MSI 属性是可选的。
值为 1 时将跳过对 RunOnce 注册表项的检查。如果未在命令行中设置,则默认值为 0。
0(如果未在命令行中设置)
URL_FILTERING_ENABLED指定是否安装 URL 内容重定向功能。值为 1 时安装该功能。您必须使用组策略设置配置要重定向的 URL。请参阅《Horizon 远程桌面功能和 GPO》文档中的“配置 URL 内容重定向”。 此 MSI 属性是可选的。0
VDM_SKIP_BROKER_REGISTRATION值为 1 时跳过未受管的桌面。无
VDM_VC_MANAGED_AGENT确定 vCenter Server 是否管理安装了 Horizon Agent 的虚拟机。 值为 1 时将桌面配置为受 vCenter Server 管理的虚拟机。 值为 0 时将桌面配置为物理机和不受 vSphere 管理的计算机。 此 MSI 属性是必要属性。
注意:未受管安装不支持安装程序修复选项。修复此类安装将导致安装受管 Horizon Agent。
无
VDM_REINSTALL指定要重新安装的已安装功能列表(以逗号分隔),仅适用于无提示模式。无
VDM_REINSTALLMODE包含字母的字符串,用于指定要执行的重新安装类型,仅适用于无提示模式。有关要使用的选项的详细信息,请参阅 https://learn.microsoft.com/zh-cn/windows/win32/msi/reinstallmode。无
VDM_SERVER_NAMEHorizon Agent 安装程序在其中注册未受管桌面的连接服务器实例的主机名或 IP 地址。此 MSI 属性仅适用于未受管的桌面。 例如:VDM_SERVER_NAME=10.123.01.01
不要将此 MSI 属性用于受 vCenter Server 管理的虚拟桌面。
提醒:此页面介绍用于将 Horizon Agent 安装到 Windows 计算机的参数,对于此安装 Horizon Agent 并指定连接服务器实例的用例,VDM_SERVER_NAME 是正确的参数名称。这与尝试将 Horizon Client 安装到 Windows 计算机的用例不同。这个与客户端相关的用例具有类似但不同的参数名称,用于为 Horizon Client 安装指定连接服务器。如果您正在研究适用于 Windows 的 Horizon Client 安装用例,请参阅《适用于 Windows 的 Omnissa Horizon Client 指南》及其有关使用命令行安装适用于 Windows 的 Horizon Client 的页面。
无
VDM_SERVER_USERNAME连接服务器实例上的管理员用户名。此 MSI 属性仅适用于未受管的桌面。 例如:VDM_SERVER_USERNAME=domain\username
不要将此 MSI 属性用于受 vCenter Server 管理的虚拟桌面。
无
VDM_SERVER_PASSWORD连接服务器管理员用户密码。此 MSI 属性仅适用于未受管的桌面。 例如:VDM_SERVER_PASSWORD=secret
不要将此 MSI 属性用于受 vCenter Server 管理的虚拟桌面。
无
VDM_IP_PROTOCOL_USAGE指定 Horizon Agent 使用的 IP 版本。有效值为 IPv4 和 IPv6。IPv4
VDM_FIPS_ENABLED指定启用还是禁用 FIPS 模式。值为 1 将启用 FIPS 模式。值为 0 将禁用 FIPS 模式。如果此属性设置为 1 并且 Windows 未处于 FIPS 模式中,则安装程序将会停止。0
VDM_FORCE_DESKTOP_AGENT如果在 Windows Server 机上安装 Horizon Agent,并将其配置为单用户 Horizon 桌面,而不是作为 RDS 主机,请将该值设置为 1。此要求适用于 vCenter Server 管理的计算机和未受管的计算机。对于托管应用程序会话的非服务器 Windows 客户机,请将该值设置为 0。 此 MSI 属性是可选的。0
VDM_PAIRING_MECHANISM指定配对方法。允许使用以下值:
1 = 指定连接服务器主机名(默认值)。需要 VDM_SERVER_NAME、VDM_SERVER_USERNAME 和 VDM_SERVER_PASSWORD。
2 = 自动发现连接服务器。不需要任何凭据。
3 = 指定 Pod 名称。需要 VDM_POD_NAME。不需要任何凭据。
注意:安装代理之前,必须在 Horizon Console 中注册该计算机,才能使用值 2 和 3。
1
VDM_POD_NAME指定 Pod 名称。例如:VDM_POD_NAME=HorizonPodName。在 VDM_PAIRING_MECHANISM=3 时需要。无

在无提示安装命令中,您可以使用 ADDLOCAL 属性来指定 Horizon Agent 安装程序配置的选项。

下表显示了您可以在命令行中输入的 Horizon Agent 选项。这些选项具有对应的安装选项,可以在交互式安装过程中取消选择或选择这些对应的安装选项。

当您没有在命令行中使用 ADDLOCAL 属性时,Horizon Agent 将安装在交互式安装过程中默认安装的所有选项(如果客户机操作系统上支持这些选项)。当您使用 ADDLOCAL=ALL 时,Horizon Agent 将安装以下所有选项,包括默认开启和默认关闭的选项(如果客户机操作系统上支持这些选项)。

有关更多信息,请参阅 Microsoft Windows Installer 命令行选项中的 ADDLOCAL 表条目。

如果您使用 ADDLOCAL 单独指定功能(不指定 ADDLOCAL=ALL),则必须始终指定 Core。

您可以使用 ADDLOCAL 和 REMOVE MSI 属性来修改功能。对于 ModifyPath 基本命令行,可以使用以下 PowerShell 命令在安装了 Horizon Agent 的系统上查询包含已安装组件的注册表:

Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* |
        Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -like '*Horizon Agent*'} | Format-Table –AutoSize

输出:

DisplayName               ModifyPath
Omnissa Horizon Agent      MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}

**注意:**在以下示例中,名称 agent-installer 表示适用于 Windows 的 Horizon Agent 安装程序文件的名称。替换为您的实际文件名。

以下示例将从现有安装中修改和移除 USB 组件:agent-installer.exe /s /v"/qn REMOVE=USB"

以下示例将通过将 Horizon Performance Tracker 替换为 Horizon Help Desk Tool 来修改代理安装:agent-installer.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”

以下示例将通过添加串行端口和扫描仪重定向来修改代理安装:agent-installer.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”

Horizon Agent 无提示安装选项和交互式自定义安装选项

无提示安装选项交互式安装中的自定义设置选项默认情况下以交互方式安装或在未使用 ADDLOCAL 时安装
核心核心 Horizon Agent 功能。 如果您指定 ADDLOCAL=ALL,将安装核心功能。是
USBUSB 重定向否
NGVCInstant Clone Agent否
RTAV实时音频-视频是
ClientDriveRedirection客户端驱动器重定向是
SerialPortRedirection串行端口重定向否
ScannerRedirection扫描仪重定向否
GEOREDIR地理位置重定向否
已弃用:V4V从 Horizon 8 2412 版本开始,V4V 选项已弃用,而不再包含在安装程序中。 否
SmartCard智能卡安装程序选项不适用于 RDSH。智能卡功能将作为 Core 的一部分安装在 RDSH 虚拟机上。
HznVaudio音频(虚拟音频驱动程序)是
HznVidd、HznVidd2间接显卡驱动程序是

这些是始终安装的隐藏且不可选的组件。
  • 如果 Windows 操作系统支持 HznVdd2 驱动程序,则会安装该驱动程序。
  • 否则,将根据以下说明安装 HznVidd 驱动程序。


注意:仅当出现以下情况时,才会安装 HznVidd 并在注册表中将其标记为“本地”:
  • 桌面模式 Windows Server 为 RS4 及更高版本(操作系统内部版本 17134 - 版本 1803),或
  • 服务器为 19H1 及更高版本(操作系统内部版本 18362 - 版本 1903)
将在具有 RDS 角色的 Windows Server 2019(版本 1809)std 和数据中心安装 HznVidd 并在注册表中将其设置为 Absent。 将在具有 RDS 角色的 Windows Server 2022 和 Windows 2025 中安装 HznVidd 并在注册表中将其设置为 Local。
TSMMRWindows Media 多媒体重定向 (MMR)是
RDP创建或编辑桌面池时,如果在命令行中使用 RDP_CHOICE=1 属性或者选择 RDP 作为默认显示协议,请在注册表中启用 RDP。 此功能在交互式安装过程中处于隐藏状态。是
RDSH3DRDS 主机上的 3D 呈现否
BlastUDPUDP 传输支持 Blast是
SdoSensorSDO 传感器重定向否
PerfTrackerHorizon Performance Tracker否
技术支持Horizon Help Desk Tool是
PrintRedirIntegrated Printing是
PCOIP设置一个注册表项,告知连接服务器 Horizon Agent 使用的是 IPv4 还是 IPv6。注意:PCoIP 组件需要安装外部 PCoIP 访问权限(例如,通过防火墙或 Unified Access Gateway)才能正常运行。是
StorageDriveRedir存储驱动器重定向否

此页面对您有帮助吗?

对本主题提供反馈

本主题对您有帮助吗?

请勿填写任何个人信息或机密信息。

正在生成链接…