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

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

表 1. Horizon Agent をサイレント インストールするための MSI プロパティ
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 を常に指定する必要があります。

ADDLOCAL および REMOVE MSI プロパティを使用して、機能を変更できます。ModifyPath ベースのコマンド ラインの場合は、次の PowerShell コマンドを使用して、 Horizon Agent がインストールされているシステムにインストール済みのコンポーネントのレジストリをクエリで確認します。
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”

表 2. Horizon Agent のサイレント インストール オプションとインタラクティブ カスタム セットアップ オプション
サイレント インストール オプション 対話的なインストールのカスタム セットアップ オプション インタラクティブなインストール時にデフォルトでインストールされる、または 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 がインストールされ、レジストリでローカルとマークされるのは、次の場合のみです。
  • デスクトップ モードの Windows Server が RS4 以降(OS ビルド 17134 - バージョン 1803)の場合or
  • サーバが 19H1 以降(OS ビルド 18362 - バージョン 1903)の場合

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 に伝えるレジストリ エントリを設定します。 はい