コマンド ラインから Horizon Agent をサイレントでインストールする場合に特定のプロパティを含めることができます。Microsoft Windows Installer (MSI)がプロパティと値を解釈できるように、PROPERTY=value 形式を使用する必要があります。サイレント アップグレードでは同じインストール コマンドが使用されます。すでにインストールされている Horizon Agent コンポーネントをサイレント モードで変更することもできます。
次の表は、コマンド ラインで使用できる Horizon Agent サイレント インストール プロパティを示しています。
MSI プロパティ | 説明 | デフォルト値 |
---|---|---|
ENABLE_UNC_REDIRECTION | UNC パス リダイレクト機能をインストールするかどうかを指定します。値に 1 を指定すると、この機能がインストールされます。グループ ポリシー設定を使用して、リダイレクトする UNC を設定する必要があります。『Horizon リモート デスクトップの機能と GPO』ドキュメントの「UNC パス リダイレクトの構成」を参照してください。 この MSI プロパティはオプションです。 |
0 |
IGNORE_DOTNET_CHECK | インストーラが.NET の最小バージョンを確認するかどうかを指定します。デフォルトでは、Horizon Performance Tracker を選択すると、インストーラは事前チェックを実行し、.NET 4.6.2 以降がインストールされているかどうか確認します。インストールされていない場合は、インストール プロセスが停止します。 値 1 を指定すると、この事前チェックがキャンセルされます。値 0 を指定すると、事前チェックが続行されます。 |
%ProgramFiles%\VMware\VMware View\Agent |
INSTALLDIR | Horizon Agent ソフトウェアがインストールされるパスおよびフォルダ。例: INSTALLDIR=""D:\abc\my folder"" パスを 2 つの二重引用符のセットで囲むと、MSI インストーラはパス内の領域を無視します。 この MSI プロパティはオプションです。 |
|
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_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 を常に指定する必要があります。
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -eq 'VMware Horizon Agent'} | Format-Table –AutoSize出力は次のとおりです。
DisplayName ModifyPath VMware Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
次の例では、USB コンポーネントを変更して既存のインストールから削除しています。VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"
次の例では、Horizon Performance Tracker を Horizon Help Desk Tool に置き換えて、エージェントのインストールを変更しています。VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”
次の例では、シリアル ポートとスキャナ リダイレクトを追加することで、エージェントのインストールを変更しています。VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
サイレント インストール オプション | 対話的なインストールのカスタム セットアップ オプション | インタラクティブなインストール時にデフォルトでインストールされる、または ADDLOCAL が使用されていない場合にインストールされる |
---|---|---|
Core | Horizon Agent の主要機能。 ADDLOCAL=ALL を指定すると、Core 機能がインストールされます。 |
はい |
PCoIP | PCoIP プロトコル エージェント | はい |
USB | USB リダイレクト | いいえ |
NGVC | Instant Clone Agent | いいえ |
RTAV | リアルタイム オーディオビデオ | はい |
ClientDriveRedirection | クライアント ドライブのリダイレクト | はい |
SerialPortRedirection | シリアル ポート リダイレクト | いいえ |
ScannerRedirection | スキャナ リダイレクト | いいえ |
GEOREDIR | 位置情報リダイレクト | いいえ |
V4V | Horizon Monitoring Service Agent | はい |
SmartCard | スマートカード インタラクティブなインストールで、この機能がデフォルトでインストールされることはありません。 |
いいえ |
VmwVaudio | VMware オーディオ(仮想オーディオ ドライバ) | はい |
VmwVidd | VMware Indirect Display Driver | はい
注: VmwVidd がインストールされ、レジストリでローカルとマークされるのは、次の場合のみです。
VmwVidd がインストールされ、RDS ロールの Windows Server 2019(バージョン 1809)Standard および Datacenter のレジストリで Absent と設定されます。 VmwVidd がインストールされ、RDS ロールの Windows Server 2022 のレジストリで Local として設定されます。 |
TSMMR | Windows Media マルチメディア リダイレクト (MMR) | はい |
RDP | コマンド ラインの RDP_CHOICE=1 プロパティを使用するか、デスクトップ プールを作成または編集する際にデフォルトの表示プロトコルとして RDP を選択する場合に、レジストリの RDP を有効にします。 この機能はインタラクティブなインストールでは非表示になっています。 |
はい |
VMWMediaProviderProxy | VMware Virtualization Pack for Skype for Business | いいえ |
RDSH3D | RDS ホストでの 3D レンダリング | いいえ |
BlastUDP | Blast の UDP 転送サポート | はい |
SdoSensor | SDO センサーのリダイレクト | いいえ |
PerfTracker | Horizon Performance Tracker | いいえ |
HelpDesk | Horizon Help Desk Tool | はい |
PrintRedir | VMware Integrated Printing | はい |
PSG | この機能は、Horizon Agent が IPv4 または IPv6 を使用しているかどうかを、Connection Server に伝えるレジストリ エントリを設定します。 | はい |