Skip to main content

2026 年 4 月 16 日

Horizon Agent for Windows のサイレント インストールのプロパティ

コマンド ラインから Horizon Agent for Windows をサイレントでインストールする場合は、特定のプロパティを含めることができます。Microsoft Windows インストーラー (MSI)がプロパティと値を解釈できるように、PROPERTY=value 形式を使用する必要があります。サイレント アップグレードでは同じインストール コマンドが使用されます。すでにインストールされている Horizon Agent コンポーネントをサイレント モードで変更することもできます。

次の表は、コマンド ラインで使用できる Horizon Agent サイレント インストール プロパティを示しています。

Horizon Agent をサイレント インストールするときの MSI プロパティ
MSI プロパティ説明デフォルト値
ENABLE_UNC_REDIRECTIONUNC パス リダイレクト機能をインストールするかどうかを指定します。値に 1 を指定すると、この機能がインストールされます。グループ ポリシー設定を使用して、リダイレクトする UNC を設定する必要があります。『Horizon リモート デスクトップの機能と GPO』の「UNC パス リダイレクトの構成」を参照してください。 この MSI プロパティはオプションです。0
HORIZON_MONITOR_ENABLEDHorizon モニタリング モードを有効にするか無効にするかを指定します。このフラグは、環境に Horizon Cloud Service - next-gen がインストールされている場合にのみ機能します。 値を 1 にすると、Horizon モニタリング モードが有効になります。値を 0 にすると、Horizon モニタリングは無効になります。0
IGNORE_DOTNET_CHECKインストーラが.NET の最小バージョンを確認するかどうかを指定します。デフォルトでは、Horizon Performance Tracker を選択すると、インストーラは事前チェックを実行し、.NET 4.6.2 以降がインストールされているかどうか確認します。インストールされていない場合は、インストール プロセスが停止します。 値 1 を指定すると、この事前チェックがキャンセルされます。値 0 を指定すると、事前チェックが続行されます。0
INSTALLDIRHorizon Agent ソフトウェアがインストールされるパスおよびフォルダ。例: INSTALLDIR=""D:\abc\my folder"" パスを 2 つの二重引用符のセットで囲むと、MSI インストーラはパス内の領域を無視します。 この MSI プロパティはオプションです。Horizon Agent は %ProgramFiles% structure. 内にインストールされます。
RDP_CHOICEデスクトップでリモート デスクトップ プロトコル(RDP)を有効にするかどうかを決定します。 値 1 を指定すると、RDP が有効になります。値 0 を指定すると、RDP 設定は無効のままです。 この MSI プロパティはオプションです。1
SUPPRESS_RUNONCE_CHECKHKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce キーと RunOnceEx キーで次のオペレーティング システム再起動時の実行が設定されている保留中の Windows Update を無視します。このフラグを使用して同時にインストールできますが、システムの更新が Horizon Agent の実行時の依存関係に影響を及ぼす場合には、インストールの結果は保証されません。 この MSI プロパティはオプションです。なし
URL_FILTERING_ENABLEDURL コンテンツ リダイレクト機能をインストールするかどうかを指定します。値に 1 を指定すると、この機能がインストールされます。グループ ポリシー設定を使用して、リダイレクトする URL を設定する必要があります。『Horizon リモート デスクトップの機能と GPO』の「URL コンテンツ リダイレクトの構成」を参照してください。 この MSI プロパティはオプションです。0
VDM_SKIP_BROKER_REGISTRATION値 1 を指定すると、管理対象外のデスクトップをスキップします。なし
VDM_VC_MANAGED_AGENTHorizon Agent がインストールされる仮想マシンを vCenter Server が管理するかどうかを決定します。 値 1 を指定すると、デスクトップは vCenter Server の管理対象仮想マシンとして構成されます。 値 0 を指定すると、デスクトップは vCenter Server の管理対象外のとして構成されます。 この MSI プロパティは必須です。 注:管理対象外のインストールでは、インストーラの修復オプションがサポートされていません。このようなインストールを修復すると、管理対象の Horizon Agent のインストールになります。なし
VDM_REINSTALL再インストールする、インストール済みの機能のリストをカンマで区切って指定します。サイレント モードでのみ適用できます。なし
VDM_REINSTALLMODE実行する再インストールのタイプを指定する文字を含む文字列。サイレント モードでのみ適用されます。使用するオプションの詳細については、https://learn.microsoft.com/ja-jp/windows/win32/msi/reinstallmode を参照してください。なし
VDM_SERVER_NAMEHorizon Agent インストーラが管理対象外のデスクトップを登録する Connection Server インスタンスのホスト名または IP アドレス。このプロパティは、管理対象外のデスクトップにのみ適用されます。例: VDM_SERVER_NAME=10.123.01.01 管理対象外のデスクトップでは、この MSI プロパティは必須です。 vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。なし
VDM_SERVER_USERNAMEConnection Server インスタンスの管理者のユーザー名。この MSI プロパティは、管理対象外のデスクトップにのみ適用されます。例: VDM_SERVER_USERNAME=domain\username 管理対象外のデスクトップでは、この MSI プロパティは必須です。 vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。なし
VDM_SERVER_PASSWORDConnection Server 管理者ユーザーのパスワード。例: VDM_SERVER_PASSWORD=secret 管理対象外のデスクトップでは、この MSI プロパティは必須です。 vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。なし
VDM_IP_PROTOCOL_USAGEHorizon Agent が使用する IP バージョンを指定します。有効な値は、IPv4 と IPv6 です。IPv4
VDM_FIPS_ENABLEDFIPS モードを有効にするか無効にするかを指定します。値 1 は FIPS モードを有効にします。値 0 は FIPS モードを無効にします。このプロパティが 1 に設定され、Windows が FIPS モードになっていない場合、インストーラは停止します。0
VDM_FORCE_DESKTOP_AGENTWindows Server マシンに Horizon Agent をインストールし、RDS ホストではなくシングル ユーザーの Horizon デスクトップとして構成する場合は、値を 1 に設定します。この要件は、vCenter Server によって管理されるマシンと管理対象外のマシンに適用されます。アプリケーション セッションをホストするサーバ以外の Windows ゲストの場合は、値を 0 に設定します。 この MSI プロパティはオプションです。0

サイレント インストール コマンドでは、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

以下に出力例を示します。{ と } の間にある GUID は、システムのエージェント ビルドによって異なります。

DisplayName        ModifyPath
Horizon Agent      MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}

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

次の例では、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 が使用されていない場合にインストールされる
CoreHorizon Agent のコア機能。 ADDLOCAL=ALL を指定すると、Core 機能がインストールされます。はい
USBUSB リダイレクトいいえ
NGVCInstant Clone Agentいいえ
RTAVリアルタイム オーディオビデオはい
ClientDriveRedirectionクライアント ドライブのリダイレクトはい
SerialPortRedirectionシリアル ポート リダイレクトいいえ
ScannerRedirectionスキャナ リダイレクトいいえ
GEOREDIR位置情報リダイレクトいいえ
V4VHorizon Monitoring Service Agentはい
SmartCardスマートカード インタラクティブなインストールで、この機能がデフォルトでインストールされることはありません。いいえ
ご使用の Horizon バージョンのオプション名については、Omnissa サポートにお問い合わせください。オーディオ(仮想オーディオ ドライバ)はい
ご使用の Horizon バージョンのオプション名については、Omnissa サポートにお問い合わせください。Indirect Display Driverはい 注:このオプションがインストールされ、レジストリでローカルとマークされるのは、次の場合のみです。
  • デスクトップ モードの Windows Server が RS4 以降(OS ビルド 17134 - バージョン 1803)の場合。または
  • サーバが 19H1 以降(OS ビルド 18362 - バージョン 1903)の場合
このオプションがインストールされ、RDS ロールの Windows Server 2019(バージョン 1809)Standard および Datacenter のレジストリで Absent と設定されます。 このオプションがインストールされ、RDS ロールの Windows Server 2022 のレジストリで Local として設定されます。
TSMMRWindows Media マルチメディア リダイレクト (MMR)はい
RDPコマンド ラインの RDP_CHOICE=1 プロパティを使用するか、デスクトップ プールを作成または編集する際にデフォルトの表示プロトコルとして RDP を選択する場合に、レジストリの RDP を有効にします。 この機能はインタラクティブなインストールでは非表示になっています。はい
RDSH3DRDS ホストでの 3D レンダリングいいえ
BlastUDPBlast の UDP 転送サポートはい
SdoSensorSDO センサーのリダイレクトいいえ
PerfTrackerHorizon Performance Trackerいいえ
ヘルプデスクHorizon Help Desk Toolはい
PrintRedirIntegrated Printingはい
PSGこの機能は、Horizon Agent が IPv4 または IPv6 を使用しているかどうかを、Connection Server に伝えるレジストリ エントリを設定します。はい

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

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

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

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

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