Skip to main content

2026 年 11 月 18 日

无提示安装适用于 Windows 的 Omnissa Horizon Agent

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

输出:


DisplayName               ModifyPath
Omnissa 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 自定义安装选项。请参阅适用于 Windows 的 Horizon Agent 的自定义安装选项。

  • 熟悉 MSI 安装程序命令行选项。请参阅 Microsoft Windows Installer 命令行选项。

  • 熟悉 Horizon Agent 可用的无提示安装属性。请参阅用于适用于 Windows 的 Horizon Agent 的无提示安装属性。

  • 熟悉 Horizon Agent 安装程序在防火墙上打开的 TCP 端口。有关更多信息,请参阅*《Horizon 概览和部署规划》*文档。

  • 确认在计划无提示安装 Horizon Agent 的客户机操作系统上安装了最新的 Windows Update 修补程序。在某些情况下,可能需要管理员进行交互式安装,以执行等待处理的 Windows Update 修补程序。确认所有操作系统操作和后续重新引导均已完成。

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

您可以在虚拟机或物理 PC 上的 Windows 命令提示符中运行这些命令。

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

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

示例一

以下示例将安装 Horizon Agent 以及 Core、Horizon Blast、Unity Touch、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、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"

示例三

以下示例将在不使用凭据的情况下在未受管的计算机上安装 Horizon Agent。此外,安装程序还会安装 Core、Horizon Blast、Unity Touch、Integrated Printing 和 USB 重定向组件。根据以下配对/注册模式之一,在向 Horizon Connection Server 注册屏幕上完成安装。

  1. **输入 Horizon Connection Server 的名称和凭据:**在对话框中,输入 CS 主机名和 HzE 管理员凭据。

    • 无提示安装选项:VDM_PAIRING_MECHANISM=1
  2. 自动发现 Horizon Connection Server:选择以自动发现并继续进入准备安装屏幕。

    • 无提示安装选项:VDM_PAIRING_MECHANISM=2
  3. 输入 Pod 名称:输入计算机将连接到的 Pod 的名称。继续进入准备安装屏幕。

    • 无提示安装选项:VDM_PAIRING_MECHANISM=3 VDM_POD_NAME=<POD name>

示例四

以下示例将从现有安装中修改和移除 USB 组件:

agent-installer.exe /s /v "/qn REMOVE=USB"

产品代码驱动的命令行示例: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”

产品代码驱动的命令行示例:msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=HelpDesk REMOVE=PerfTracker

示例六

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

产品代码驱动的命令行示例:msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=SerialPortRedirection,ScannerRedirection

安装完成后

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

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

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

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

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

    示例文件: C:\Users\demo\agent-settings.txt

  VDM_VC_MANAGED_AGENT=0

   VDM_SERVER_NAME=cs1.companydomain.com

   VDM_SERVER_USERNAME=admin.companydomain.com

   ADDLOCAL=HelpDesk

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

    示例:

    agent-installer.exe /s /v "/qn SETTINGS_FILE=C:\Users\demo\agent-settings.txt VDM_SERVER_PASSWORD=secret"

安装完成后

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

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…