Skip to main content

2026 年 5 月 8 日

Omnissa Horizon Agent for Windows のサイレント インストール

Microsoft Windows インストーラ (MSI) のサイレント インストール機能を使用して、複数の Windows 仮想マシンまたは物理コンピュータに Horizon Agent をインストールできます。サイレント インストールでは、ウィザードのプロンプトに応答する必要はありません。サイレント アップグレードでは同じインストール コマンドが使用されます。すでにインストールされている Horizon Agent コンポーネントをサイレント モードで変更することもできます。

コマンド ラインでパラメータを手動入力するか、設定ファイルを使用してサイレント インストールを実行できます。

サイレント インストールについて

サイレント インストールを使うと、大規模企業に Horizon 8 のコンポーネントを効率よく展開できます。

自動的に、つまりデフォルトでインストールされる機能の一部がインストールされないようにする場合は、ADDLOCAL MSI プロパティを使用して個々のセットアップ オプションと機能を選択的にインストールできます。ADDLOCAL プロパティの詳細については、「 Microsoft Windows インストーラのコマンド ライン オプション」の表を参照してください。

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 のインストールとアップグレード』を参照してください。

  • デスクトップの展開のためにゲスト OS を準備します。「リモート デスクトップの展開のためのゲスト OS の準備」を参照してください。

  • Windows Server 仮想マシンを単一セッションのリモート デスクトップまたは RDSH ホストとして使用するには、「デスクトップで使用するための Windows Server OS の準備」で説明されている手順を実行します。

    **注:**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 はビルド番号です。

  • 仮想マシンまたは物理 PC に対する管理者権限があることを確認します。

  • Horizon Agent カスタム セットアップ オプションについて理解しておきます。「Horizon Agent for Windows のカスタム セットアップ オプション」を参照してください。

  • MSI インストーラのコマンドライン オプションについて理解しておきます。「Microsoft Windows Installer のコマンドライン オプション」を参照してください。

  • Horizon Agent で使用できるサイレント インストールのプロパティについて理解しておきます。「Horizon Agent for Windows のサイレント インストールのプロパティ」を参照してください。

  • Horizon Agent インストール プログラムによってファイアウォール上で開かれる TCP ポートについて理解しておきます。詳細については、『Horizon の概要と展開計画』を参照してください。

  • Horizon Agent をサイレント インストールする予定のゲスト OS に、最新の Windows Update パッチがインストールされていることを確認します。場合によっては、Windows Update パッチの保留を実行するために、管理者によるインタラクティブなインストールを行う必要があります。すべての OS 操作とその後の再起動が完了していることを確認します。

コマンド ラインのパラメータによる Horizon Agent のサイレント インストール

これらのコマンドは、仮想マシンまたは物理 PC の Windows コマンド プロンプトで実行できます。

**注:**Windows Server マシンに Horizon Agent をインストールし、そのマシンを RDS ホストとしてではなくシングルユーザー Horizon デスクトップとして構成する場合は、インストール コマンドに VDM_FORCE_DESKTOP_AGENT=1 プロパティを含める必要があります。この要件は、vCenter Server によって管理されるマシンと管理対象外のマシンに適用されます。

**注:**次の例の agent-installer.exe は、ダウンロードされたインストーラ ファイルの名前を表しています。実際に使用するインストーラのファイル名に置き換えてください。

例 1

次の例では、Core、Horizon Blast、PCoIP、Unity Touch、PSG、USB リダイレクト、およびリアルタイム オーディオビデオのコンポーネントとともに、Horizon Agent をインストールします。

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

例 2

次の例では、管理対象外のコンピュータに Horizon Agent をインストールします。また、インストーラは、Core、Horizon Blast、PCoIP、Unity Touch、PSG、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. ポッドの名前を入力:コンピュータが接続するポッドの名前を入力します。[インストールの準備完了] 画面に進みます。

    • サイレント インストール オプション:VDM_PAIRING_MECHANISM=3 VDM_POD_NAME=<POD name>

例 3

次の例では、USB コンポーネントを変更して既存のインストールから削除しています。

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

ProductCode ベースのコマンドラインの例:msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn REMOVE=USB

例 4

次の例では、Horizon Performance Tracker を Horizon Help Desk Tool に置き換えることで、エージェントのインストールを変更しています。 agent-installer.exe /s /v "/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”

ProductCode ベースのコマンドラインの例:msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=HelpDesk REMOVE=PerfTracker

例 5

次の例では、シリアル ポートとスキャナ リダイレクトを追加することで、エージェントのインストールを変更しています。 agent-installer.exe /s /v "/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”

ProductCode ベースのコマンドラインの例:msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=SerialPortRedirection,ScannerRedirection

インストールの完了

インストールが完了した後、仮想マシンが複数の NIC を使用する場合は、Horizon Agent が使用するサブネットを構成します。「Horizon Agent のための複数の NIC を使用する仮想マシンの構成」を参照してください。

設定ファイルを使用した Horizon Agent のサイレント インストール

  1. インストールに使用するパラメータを含むテキスト ファイルを作成します。

    • このファイルは、ローカル ドライブまたはネットワーク ドライブのいずれかに配置できます。マッピングされたドライブも使用できます。
    • ファイルには任意の拡張子を付けることができますが、テキスト形式にする必要があります。
    • 各パラメータは独自の行に記述する必要があります。
    • その他のテキスト(パラメータは除く)は、行の先頭にハッシュ記号 (#) を付けてコメント アウトする必要があります。
    • ファイルでは、空白と空白改行の両方が許可されます。 **注:**Windows Server マシンに Horizon Agent をインストールし、そのマシンを RDS ホストとしてではなくシングルユーザー Horizon デスクトップとして構成する場合は、設定ファイルに VDM_FORCE_DESKTOP_AGENT=1 プロパティを含める必要があります。この要件は、vCenter Server によって管理されるマシンと管理対象外のマシンに適用されます。

    **重要:**インストーラはパスワードを処理しません。ファイルに VDM_SERVER_PASSWORD などの既知のパスワード プロパティが含まれていると、インストーラはファイルの解析に失敗し、エラーを返します。パスワードを含める場合は、コマンド ラインで手動で入力する必要があります。この方法でパスワードを入力すると、パスワードは 1 回だけ渡されますが、どこにも記録されません。

    サンプル ファイル: 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"

インストールの完了

インストールが完了した後、仮想マシンが複数の NIC を使用する場合は、Horizon Agent が使用するサブネットを構成します。「Horizon Agent のための複数の NIC を使用する仮想マシンの構成」を参照してください。

このページは役に立ちましたか?

このトピックについてフィードバックを送信

このトピックは役に立ちましたか?

個人情報や機密情報は入力しないでください。

リンクを生成しています…