Skip to main content

2026 年 7 月 10 日

无提示安装 Omnissa Horizon Agent for Windows

您可以使用 Microsoft Windows Installer (MSI) 的无提示安装功能,在若干 Windows 虚拟机或物理机上安装 Horizon Agent。在无提示安装中,您无需响应向导的提示。无提示升级使用相同的安装命令。您还可以用无提示方式修改已安装的 Horizon Agent 组件。

您可以通过在命令行中手动输入参数或使用设置文件来执行无提示安装。

关于无提示安装

通过无提示安装,您可以在大型企业中高效部署 Horizon 8 组件。

如果您不希望安装自动或默认安装的所有功能,则可以使用 ADDLOCAL MSI 属性有选择地安装各个安装选项和功能。有关 ADDLOCAL 属性的详细信息,请参阅 Microsoft Windows Installer 命令行选项中的表。

您可以使用 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}

必备条件

  • 确认您已准备好 Active Directory。请参阅*《Horizon 8 安装和升级》*文档。

  • 为桌面部署准备客户机操作系统。请参阅为远程桌面部署准备客户机操作系统

  • 要使用 Windows Server 作为单一会话远程桌面或作为 RDSH 主机,请执行准备 Windows Server 操作系统供桌面使用中所述的步骤。

    **注意:**Horizon Agent 安装程序不会自动以无提示模式安装任何角色。如果想要使用 RDS 模式,请在系统上预安装 RDSH 角色。

  • 如果计算机安装了 Microsoft Visual C++ Redistributable 软件包,请确认软件包的版本为 2005 SP1 或更高版本。如果软件包的版本为 2005 或更低版本,可以升级或卸载该软件包。

  • Omnissa Customer Connect 下载 Horizon Agent 安装程序文件。

安装程序文件名采用 Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe 模式,其中 YYMM 是营销版本号,y.y.y 是内部的版本号,xxxxxx 是内部版本号。

  • 确认您具有虚拟机或物理机的管理权限。
  • 熟悉 Horizon Agent 自定义安装选项。请参阅 Horizon Agent for Windows 的自定义安装选项
  • 熟悉 MSI 安装程序命令行选项。请参阅 Microsoft Windows Installer 命令行选项
  • 熟悉 Horizon Agent 可用的无提示安装属性。请参阅用于 Horizon Agent for Windows 的无提示安装属性
  • 熟悉 Horizon Agent 安装程序在防火墙上打开的 TCP 端口。有关更多信息,请参阅*《Horizon 概览和部署规划》*文档。
  • 确认在计划无提示安装 Horizon Agent 的客户机操作系统上安装了最新的 Windows Update 修补程序。在某些情况下,可能需要管理员进行交互式安装,以执行等待处理的 Windows Update 修补程序。确认所有操作系统操作和后续重新引导均已完成。

通过在命令行中输入参数来无提示安装 Horizon Agent

  1. 在虚拟机或物理机上打开一个 Windows 命令提示符。**注意:**在以下示例中,名称 agent-installer.exe 代表下载的安装程序文件。替换正在使用的安装程序 exe 的名称。

    以下示例将安装 Horizon Agent 以及 Core、Horizon Blast、PCoIP、Unity Touch、PSG、USB 重定向和实时音频-视频组件。

    agent-installer.exe /s /v "/qn VDM_VC_MANAGED_AGENT=1 ADDLOCAL=Core,USB,RTAV"

    以下示例将在未受管的计算机上安装 Horizon Agent,并在指定的连接服务器 cs1.companydomain.com 中注册桌面。此外,安装程序还会安装 Core、Horizon Blast、PCoIP、Unity Touch、PSG、Integrated Printing 和 USB 重定向组件。

    agent-installer.exe /s /v "/qn VDM_VC_MANAGED_AGENT=0 VDM_SERVER_NAME=cs1.companydomain.com VDM_SERVER_USERNAME=admin.companydomain.com VDM_SERVER_PASSWORD=secret ADDLOCAL=Core,PrintRedir,USB"

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

    ProductCode 驱动的命令行示例(替换实际的 {GUID} 值):msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn REMOVE=USB

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

    ProductCode 驱动的命令行示例(替换实际的 {GUID} 值):msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=HelpDesk REMOVE=PerfTracker

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

    ProductCode 驱动的命令行示例(替换实际的 {GUID} 值):msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=SerialPortRedirection,ScannerRedirection

    **注意:**如果在 Windows Server 计算机上安装 Horizon Agent,并想要配置该计算机作为单用户 Horizon 桌面而非作为 RDS 主机,则必须在安装命令中包含 VDM_FORCE_DESKTOP_AGENT=1 属性。此要求适用于受 vCenter Server 管理的计算机和未受管的计算机。

安装完成后,如果虚拟机具有多个网卡,则需要配置 Horizon Agent 使用的子网。请参阅为 Horizon Agent 配置具有多个网卡的虚拟机

使用设置文件无提示安装 Horizon Agent

  1. 创建包含要用于安装的参数的文本文件。

    • 该文件可以位于本地驱动器或网络驱动器上。也支持使用映射的驱动器。
    • 该文件可以具有任何扩展名,但必须是纯文本。
    • 每个参数必须单独占一行。
    • 必须在行首使用井号 (#) 注释掉任何其他文本(以及参数本身)。
    • 该文件中允许使用空格和空的换行符。 **注意:**如果在 Windows Server 计算机上安装 Horizon Agent,并想要配置该计算机作为单用户 Horizon 桌面而非作为 RDS 主机,则必须在设置文件中包含 VDM_FORCE_DESKTOP_AGENT=1 属性。此要求适用于受 vCenter Server 管理的计算机和未受管的计算机。

    **注意:**安装程序不会处理密码。如果您的文件包含已知密码属性(如 VDM_SERVER_PASSWORD),则安装程序将无法解析该文件并返回一个错误。要包含密码,必须在命令行中手动输入该密码。以这种方式输入密码时,该密码仅传递一次,并且不会记录在任何地方。

  2. 在虚拟机或物理 PC 上打开 Windows 命令提示符,并输入以下内容(使用您现有的代理安装程序文件的名称替换 agent-installer.exe 并使用 agent-settings.txt 文件的文件路径)。

    agent-installer.exe /v SETTINGS_FILE=<file path>

    例如:

    agent-installer.exe /v SETTINGS_FILE=C:\Users\demo\agent-settings.txt

安装完成后,如果虚拟机具有多个网卡,则需要配置 Horizon Agent 使用的子网。请参阅为 Horizon Agent 配置具有多个网卡的虚拟机

此页面对您有帮助吗?

对本主题提供反馈

本主题对您有帮助吗?

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

正在生成链接…