从命令行无提示安装 Horizon Agent 时,可以包含特定属性。您必须使用 PROPERTY=value 的格式,以便 Microsoft Windows Installer (MSI) 理解各属性和值。无提示升级使用相同的安装命令。您还可以用无提示方式修改已安装的 Horizon Agent 组件。
下表显示了您可在命令行中使用的 Horizon Agent 无提示安装属性。
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_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。
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"
无提示安装选项 | 交互式安装中的自定义设置选项 | 以交互方式默认安装或在未使用 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 并在注册表中将其标记为“本地”:
将在具有 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。 | 是 |