Skip to main content

2026 年 4 月 16 日

Horizon Agent for Windows 的无提示安装属性

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

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

静默安装 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 属性是可选的。Horizon Agent 安装在 %ProgramFiles% structure.
RDP_CHOICE确定是否在桌面上启用远程桌面协议 (RDP)。 值为 1 时启用 RDP。值为 0 时停用 RDP 设置。 此 MSI 属性是可选的。1
SUPPRESS_RUNONCE_CHECK忽略 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnceRunOnceEx 注册表项中计划在下次重新引导操作系统时执行的待处理 Windows 更新任务。使用此标记可允许并行安装,但当系统更新影响 Horizon Agent 运行时依赖关系时,不能保证获得所需的安装结果。 此 MSI 属性是可选的。
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 时将桌面配置为不受 vCenter Server 管理。 此 MSI 属性是必要属性。 注意:未受管安装不支持安装程序修复选项。修复此类安装将导致安装受管 Horizon Agent。
VDM_REINSTALL指定要重新安装的已安装功能列表(以逗号分隔),仅适用于无提示模式。
VDM_REINSTALLMODE包含字母的字符串,用于指定要执行的重新安装类型,仅适用于无提示模式。有关要使用的选项的详细信息,请参阅 https://learn.microsoft.com/zh-cn/windows/win32/msi/reinstallmode
VDM_SERVER_NAMEHorizon Agent 安装程序在其中注册未受管桌面的连接服务器实例的主机名或 IP 地址。此属性适用于未受管的桌面。例如: VDM_SERVER_NAME=10.123.01.01 此 MSI 属性是未受管桌面的必要属性。 不要将此 MSI 属性用于受 vCenter Server 管理的虚拟桌面。
VDM_SERVER_USERNAME连接服务器实例上的管理员用户名。此 MSI 属性只适用于未受管的桌面。例如: VDM_SERVER_USERNAME=domain\username 此 MSI 属性是未受管桌面的必要属性。 不要将此 MSI 属性用于受 vCenter Server 管理的虚拟桌面。
VDM_SERVER_PASSWORD连接服务器管理员用户密码。例如: VDM_SERVER_PASSWORD=secret 此 MSI 属性是未受管桌面的必要属性。 不要将此 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

在无提示安装命令中,您可以使用 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

以下是一个示例输出(根据系统中的代理内部版本,{ 和 } 之间的 GUID 将有所不同)。

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

**注意:**在以下示例中,名称 agent-installer.exe 代表下载的安装程序文件。替换正在使用的安装程序 exe 的名称。

以下示例将从现有安装中修改和移除 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地理位置重定向
V4VHorizon Monitoring Service Agent
SmartCard智能卡 默认情况下,在交互式安装中不安装此功能。
有关适用于您的 Horizon 版本的选项名称,请联系 Omnissa 技术支持团队。音频(虚拟音频驱动程序)
有关适用于您的 Horizon 版本的选项名称,请联系 Omnissa 技术支持团队。间接显卡驱动程序注意:仅当出现以下情况时,才会安装此选项并在注册表中将其标记为 Local:
  • 桌面模式 Windows Server 为 RS4 及更高版本(操作系统内部版本 17134 - 版本 1803),或
  • 服务器为 19H1 及更高版本(操作系统内部版本 18362 - 版本 1903)
将在具有 RDS 角色的 Windows Server 2019(版本 1809)std 和数据中心安装此选项并在注册表中将其设置为 Absent。 将在具有 RDS 角色的 Windows Server 2022 中安装此选项并在注册表中将其设置为 Local。
TSMMRWindows Media 多媒体重定向 (MMR)
RDP创建或编辑桌面池时,如果在命令行中使用 RDP_CHOICE=1 属性或者选择 RDP 作为默认显示协议,请在注册表中启用 RDP。 此功能在交互式安装过程中处于隐藏状态。
RDSH3DRDS 主机上的 3D 呈现
BlastUDPUDP 传输支持 Blast
SdoSensorSDO 传感器重定向
PerfTrackerHorizon Performance Tracker
技术支持Horizon Help Desk Tool
PrintRedirIntegrated Printing
PSG此功能可以设置一个注册表项,使连接服务器知道 Horizon Agent 使用的是 IPv4 还是 IPv6。

此页面对您有帮助吗?

对本主题提供反馈

本主题对您有帮助吗?

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

正在生成链接…