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

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

表 1. 无提示安装 Horizon Agent 的 MSI 属性
MSI 属性 说明 默认值
ENABLE_UNC_REDIRECTION 指定是否安装了 UNC 路径重定向功能。值为 1 时安装该功能。您必须使用组策略设置配置要重定向的 UNC。请参阅《Horizon 远程桌面功能和 GPO》文档中的“配置 UNC 路径重定向”。

此 MSI 属性是可选的。

 0
HORIZON_MONITOR_ENABLED 指定启用还是禁用 Horizon 监控模式。仅当您的环境中安装了 VMware Horizon Cloud Service - next-gen 时，此标记才有效。

值为 1 将启用 Horizon 监控模式。值为 0 将禁用 Horizon 监控模式。

 0
IGNORE_DOTNET_CHECK 确定安装程序是否检查最低 .NET 版本。默认情况下，选择 Horizon Performance Tracker 后，安装程序会执行预检查以确认是否安装了 .NET 4.6.2 或更高版本，如未安装，则会停止安装过程。

值为 1 时取消此预检查。值为 0 时允许继续执行预检查。

%ProgramFiles%\VMware\VMware View\Agent
INSTALLDIR Horizon Agent 软件的安装路径和文件夹。例如：

INSTALLDIR=""D:\abc\my folder""

括住路径的两组双引号可允许 MSI 安装程序忽略路径中的空格。

此 MSI 属性是可选的。

RDP_CHOICE 确定是否在桌面上启用远程桌面协议 (RDP)。

值为 1 时启用 RDP。值为 0 时停用 RDP 设置。

此 MSI 属性是可选的。

1
SUPPRESS_RUNONCE_CHECK 忽略 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce 和 RunOnceEx 注册表项中计划在下次重新引导操作系统时执行的待处理 Windows Update 任务。使用此标记可允许并行安装，但当系统更新影响 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_NAME Horizon 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 -eq 'VMware Horizon
        Agent'} | Format-Table –AutoSize
输出： 
DisplayName               ModifyPath
          VMware Horizon Agent      MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}

以下示例将从现有安装中修改和移除 USB 组件：VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"

以下示例将通过将 Horizon Performance Tracker 替换为 Horizon Help Desk Tool 来修改代理安装：VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker"

以下示例将通过添加串行端口和扫描仪重定向来修改代理安装：VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection"

表 2. Horizon Agent 无提示安装选项和交互式自定义安装选项
无提示安装选项 交互式安装中的自定义设置选项 以交互方式默认安装或在未使用 ADDLOCAL 时默认安装
核心 Horizon Agent 核心功能。

如果您指定 ADDLOCAL=ALL，将安装核心功能。

是
USB USB 重定向 否
NGVC Instant Clone Agent 否
RTAV 实时音频-视频 是
ClientDriveRedirection 客户端驱动器重定向 是
SerialPortRedirection 串行端口重定向 否
ScannerRedirection 扫描仪重定向 否
GEOREDIR 地理位置重定向 否
V4V Horizon Monitoring Service Agent 是
SmartCard 智能卡

默认情况下，在交互式安装中不安装此功能。

否
VmwVaudio VMware 音频（虚拟音频驱动程序） 是
VmwVidd VMware 间接显卡驱动程序 是
注： 仅当出现以下情况时，才会安装 VmwVidd 并在注册表中将其标记为“本地”：
  • 桌面模式 Windows Server 为 RS4 及更高版本（操作系统内部版本 17134 - 版本 1803），or
  • 服务器为 19H1 及更高版本（操作系统内部版本 18362 - 版本 1903）

将在具有 RDS 角色的 Windows Server 2019（版本 1809）std 和数据中心安装 VmwVidd 并在注册表中将其设置为 Absent。

将在具有 RDS 角色的 Windows Server 2022 中安装 VmwVidd 并在注册表中将其设置为 Local。
TSMMR Windows Media 多媒体重定向 (MMR) 是
RDP 创建或编辑桌面池时，如果在命令行中使用 RDP_CHOICE=1 属性或者选择 RDP 作为默认显示协议，请在注册表中启用 RDP。

此功能在交互式安装过程中处于隐藏状态。

是
RDSH3D RDS 主机上的 3D 呈现 否
BlastUDP UDP 传输支持 Blast 是
SdoSensor SDO 传感器重定向 否
PerfTracker Horizon Performance Tracker 否
HelpDesk Horizon Help Desk Tool 是
PrintRedir VMware Integrated Printing 是
PSG 此功能可以设置一个注册表项，告诉连接服务器 Horizon Agent 使用的是 IPv4 还是 IPv6。 是