コマンド ラインから Horizon Agent for Windows をサイレントでインストールする場合は、特定のプロパティを含めることができます。Microsoft Windows インストーラー (MSI)がプロパティと値を解釈できるように、PROPERTY=value 形式を使用する必要があります。サイレント アップグレードでは同じインストール コマンドが使用されます。すでにインストールされている Horizon Agent コンポーネントをサイレント モードで変更することもできます。
次の表は、コマンド ラインで使用できる Horizon Agent サイレント インストール プロパティを示しています。
| 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 プロパティはオプションです。 | Horizon Agent は %ProgramFiles% structure. 内にインストールされます。 |
| 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 を指定すると、デスクトップは vCenter Server の管理対象外のとして構成されます。 この 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 アドレス。このプロパティは、管理対象外のデスクトップにのみ適用されます。例:
VDM_SERVER_NAME=10.123.01.01
管理対象外のデスクトップでは、この MSI プロパティは必須です。
vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。 | なし |
| VDM_SERVER_USERNAME | Connection Server インスタンスの管理者のユーザー名。この MSI プロパティは、管理対象外のデスクトップにのみ適用されます。例:
VDM_SERVER_USERNAME=domain\username
管理対象外のデスクトップでは、この MSI プロパティは必須です。
vCenter Server の管理対象の仮想デスクトップには、この MSI プロパティを使用しないでください。 | なし |
| VDM_SERVER_PASSWORD | Connection Server 管理者ユーザーのパスワード。例:
VDM_SERVER_PASSWORD=secret
管理対象外のデスクトップでは、この MSI プロパティは必須です。
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 |
サイレント インストール コマンドでは、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"
| サイレント インストール オプション | 対話的なインストールのカスタム セットアップ オプション | インタラクティブなインストール時にデフォルトでインストールされる、または ADDLOCAL が使用されていない場合にインストールされる |
|---|---|---|
| Core | Horizon Agent のコア機能。 ADDLOCAL=ALL を指定すると、Core 機能がインストールされます。 | はい |
| USB | USB リダイレクト | いいえ |
| NGVC | Instant Clone Agent | いいえ |
| RTAV | リアルタイム オーディオビデオ | はい |
| ClientDriveRedirection | クライアント ドライブのリダイレクト | はい |
| SerialPortRedirection | シリアル ポート リダイレクト | いいえ |
| ScannerRedirection | スキャナ リダイレクト | いいえ |
| GEOREDIR | 位置情報リダイレクト | いいえ |
| V4V | Horizon Monitoring Service Agent | はい |
| SmartCard | スマートカード インタラクティブなインストールで、この機能がデフォルトでインストールされることはありません。 | いいえ |
| ご使用の Horizon バージョンのオプション名については、Omnissa サポートにお問い合わせください。 | オーディオ(仮想オーディオ ドライバ) | はい |
| ご使用の Horizon バージョンのオプション名については、Omnissa サポートにお問い合わせください。 | Indirect Display Driver | はい
注:このオプションがインストールされ、レジストリでローカルとマークされるのは、次の場合のみです。
|
| 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 に伝えるレジストリ エントリを設定します。 | はい |
このページは役に立ちましたか?