コマンド ラインから Horizon Agent for Windows をサイレントでインストールする場合は、特定のプロパティを含めることができます。Microsoft Windows インストーラー （MSI）がプロパティと値を解釈できるように、PROPERTY=value 形式を使用する必要があります。サイレント アップグレードでは同じインストール コマンドが使用されます。すでにインストールされている Horizon Agent コンポーネントをサイレント モードで変更することもできます。
次の表は、コマンド ラインで使用できる Horizon Agent サイレント インストール プロパティを示しています。
**注：**以下の手順では、インストーラ ファイルの名前に agent-installer.exe を使用しています。
Horizon Agent をサイレント インストールするときの MSI プロパティ
| MSI プロパティ | 説明 | デフォルト値 |
|---|---|---|
| ENABLE_UNC_REDIRECTION | UNC パス リダイレクト機能をインストールするかどうかを指定します。値に 1 を指定すると、この機能がインストールされます。グループ ポリシー設定を使用して、リダイレクトする UNC を設定する必要があります。『Horizon リモート デスクトップの機能と GPO』の「UNC パス リダイレクトの構成」を参照してください。 この MSI プロパティはオプションです。 | 0 |
| HORIZON_MONITOR_ENABLED | Horizon モニタリング モードを有効にするか無効にするかを指定します。このフラグは、環境に Horizon Cloud Service - next-gen がインストールされている場合にのみ機能します。 値を 1 にすると、Horizon モニタリング モードが有効になります。値を 0 にすると、Horizon モニタリングは無効になります。 | 0 |
| IGNORE_DOTNET_CHECK | インストーラが.NET の最小バージョンを確認するかどうかを指定します。デフォルトでは、Horizon Performance Tracker を選択すると、インストーラは事前チェックを実行し、.NET 4.6.2 以降がインストールされているかどうか確認します。インストールされていない場合は、インストール プロセスが停止します。 値 1 を指定すると、この事前チェックがキャンセルされます。値 0 を指定すると、事前チェックが続行されます。 | 0 |
| INSTALLDIR | Horizon Agent ソフトウェアがインストールされるパスおよびフォルダ。例：
INSTALLDIR=""D:\abc\my folder""
パスを 2 つの二重引用符のセットで囲むと、MSI インストーラはパス内の領域を無視します。
この MSI プロパティはオプションです。 | %ProgramFiles%\Omnissa\Horizon\Agent |
| 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 | Horizon Agent がインストールされる仮想マシンを vCenter Server が管理するかどうかを決定します。
値 1 を指定すると、デスクトップは vCenter Server の管理対象仮想マシンとして構成されます。
値 0 を指定すると、デスクトップが物理マシンとして、または vSphere で管理されていないマシンとして構成されます。
この MSI プロパティは必須です。
注：管理対象外のインストールでは、インストーラの修復オプションがサポートされていません。このようなインストールを修復すると、管理対象の Horizon Agent のインストールになります。 | なし |
| VDM_REINSTALL | 再インストールする、インストール済みの機能のリストをカンマで区切って指定します。サイレント モードでのみ適用できます。 | なし |
| VDM_REINSTALLMODE | 実行する再インストールのタイプを指定する文字を含む文字列。サイレント モードでのみ適用されます。使用するオプションの詳細については、https://learn.microsoft.com/ja-jp/windows/win32/msi/reinstallmode を参照してください。 | なし |
| VDM_SERVER_NAME | Horizon Agent インストーラが管理対象外のデスクトップを登録する Connection Server インスタンスのホスト名または IP アドレス。この MSI プロパティは、管理対象外のデスクトップにのみ適用されます。
例：VDM_SERVER_NAME=10.123.01.01
vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。 リマインダ：このページでは、Horizon Agent を Windows マシンにインストールするためのパラメータについて説明します。VDM_SERVER_NAME は、Horizon Agent をインストールして Connection Server インスタンスを指定するこの使用事例の正しいパラメータ名です。これは、Horizon Client を Windows マシンにインストールする使用事例とは異なります。このクライアント関連の使用事例では、Horizon Client のインストールで Connection Server を指定するパラメータが似ていますが、パラメータの名前が異なります。Horizon Client for Windows のインストールの使用事例を確認している場合は、代わりに『Omnissa Horizon Client for Windows ガイド』と、コマンドラインを使用した Horizon Client for Windows のインストールに関するページを参照してください。 | なし |
| VDM_SERVER_USERNAME | Connection Server インスタンスの管理者のユーザー名。この MSI プロパティは、管理対象外のデスクトップにのみ適用されます。
例：VDM_SERVER_USERNAME=domain\username
vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。 | なし |
| VDM_SERVER_PASSWORD | Connection Server 管理者ユーザーのパスワード。この MSI プロパティは、管理対象外のデスクトップにのみ適用されます。
例：VDM_SERVER_PASSWORD=secret
vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。 | なし |
| 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 をインストールし、RDS ホストではなくシングル ユーザーの Horizon デスクトップとして構成する場合は、値を 1 に設定します。この要件は、vCenter Server によって管理されるマシンと管理対象外のマシンに適用されます。アプリケーション セッションをホストするサーバ以外の Windows ゲストの場合は、値を 0 に設定します。 この MSI プロパティはオプションです。 | 0 |
| VDM_PAIRING_MECHANISM | ペアリング方法を指定します。次の値を使用できます。
1 = Connection Server のホスト名を指定します（デフォルト）。VDM_SERVER_NAME、VDM_SERVER_USERNAME、VDM_SERVER_PASSWORD が必要です。 2 = Connection Server を自動検出します。認証情報は不要です。 3 = ポッド名を指定します。VDM_POD_NAME が必要です。認証情報は不要です。 注：値 2 と 3 を使用するには、エージェントをインストールする前にマシンを Horizon Console で登録する必要があります。 | 1 |
| VDM_POD_NAME | ポッド名を指定します。例：VDM_POD_NAME=HorizonPodName。VDM_PAIRING_MECHANISM=3 の場合に必須です。 | なし |
サイレント インストール コマンドでは、ADDLOCAL プロパティを使用して、Horizon Agent インストーラが設定するオプションを指定できます。
次の表は、コマンド ラインで入力できる Horizon Agent オプションを示しています。これらのオプションには対応するセットアップ オプションがあり、それらのオプションはインタラクティブ インストールで選択解除または選択できます。
コマンド ラインで ADDLOCAL プロパティを使用しない場合、Horizon Agent はインタラクティブなインストール時にデフォルトでインストールされるすべてのオプションをインストールします（ゲスト OS でサポートされている場合）。ADDLOCAL=ALL を使用すると、Horizon Agent は次のオプションを、デフォルトでオンのものもオフのものもすべてインストールします（ゲスト OS でサポートされている場合）。
詳細については、「Microsoft Windows インストーラー コマンド ライン オプション」で ADDLOCAL 表の項目を参照してください。
ADDLOCAL を使用して機能を個々に指定する場合、つまり ADDLOCAL=ALL を指定しない場合は、Core を常に指定する必要があります。
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}
注： 次の例では、Horizon Agent for Windows インストーラ ファイルの名前を agent-installer という名前で表しています。これは実際のファイル名と置き換えてください。
次の例では、USB コンポーネントを変更して既存のインストールから削除しています。agent-installer.exe /s /v"/qn REMOVE=USB"
次の例では、Horizon Performance Tracker を Horizon Help Desk Tool に置き換えることで、エージェントのインストールを変更しています。agent-installer.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”
次の例では、シリアル ポートとスキャナ リダイレクトを追加することで、エージェントのインストールを変更しています。agent-installer.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
Horizon Agent のサイレント インストール オプションとインタラクティブ カスタム セットアップ オプション
| サイレント インストール オプション | 対話的なインストールのカスタム セットアップ オプション | インタラクティブなインストール時にデフォルトでインストールされる、または ADDLOCAL が使用されていない場合にインストールされる |
|---|---|---|
| Core | Horizon Agent のコア機能。 ADDLOCAL=ALL を指定すると、Core 機能がインストールされます。 | はい |
| USB | USB リダイレクト | いいえ |
| NGVC | Instant Clone Agent | いいえ |
| RTAV | リアルタイム オーディオビデオ | はい |
| ClientDriveRedirection | クライアント ドライブのリダイレクト | はい |
| SerialPortRedirection | シリアル ポート リダイレクト | いいえ |
| ScannerRedirection | スキャナ リダイレクト | いいえ |
| GEOREDIR | 位置情報リダイレクト | いいえ |
| 廃止：V4V | V4V オプションは Horizon 8 2412 リリースから廃止され、インストーラに含まれなくなりました。 | いいえ |
| SmartCard | スマートカード インタラクティブなインストールで、この機能がデフォルトでインストールされることはありません。 | いいえ |
| HznVaudio | オーディオ（仮想オーディオ ドライバ） | はい |
| HznVidd、HznVidd2 | Indirect Display Driver | はい
これらは、常にインストールされる非表示の非オプション コンポーネントです。
注：HznVidd がインストールされ、レジストリでローカルとマークされるのは、次の場合のみです。
|
| TSMMR | Windows Media マルチメディア リダイレクト (MMR) | はい |
| RDP | コマンド ラインの RDP_CHOICE=1 プロパティを使用するか、デスクトップ プールを作成または編集する際にデフォルトの表示プロトコルとして RDP を選択する場合に、レジストリの RDP を有効にします。 この機能はインタラクティブなインストールでは非表示になっています。 | はい |
| RDSH3D | RDS ホストでの 3D レンダリング | いいえ |
| BlastUDP | Blast の UDP 転送サポート | はい |
| SdoSensor | SDO センサーのリダイレクト | いいえ |
| PerfTracker | Horizon Performance Tracker | いいえ |
| ヘルプデスク | Horizon Help Desk Tool | はい |
| PrintRedir | Integrated Printing | はい |
| PSG | この機能は、Horizon Agent が IPv4 または IPv6 を使用しているかどうかを、Connection Server に伝えるレジストリ エントリを設定します。 | はい |
| StorageDriveRedir | ストレージ ドライブのリダイレクト | いいえ |
このページは役に立ちましたか?