从命令行无提示安装 Horizon Agent 时,可以包含特定属性。您必须使用 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\RunOnceRunOnceEx 注册表项中计划在下次重新引导操作系统时执行的待处理 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_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

您可以使用 ADDLOCALREMOVE 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,将安装核心功能。

PCoIP PCoIP 协议代理
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。