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

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

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

表 1. Horizon Agent をサイレントインストールするための MSI プロパティ
MSI プロパティ	説明	デフォルト値
INSTALLDIR	Horizon Agent ソフトウェアがインストールされるパスおよびフォルダ。例： INSTALLDIR=""D:\abc\my folder"" パスを 2 つの二重引用符のセットで囲むと、MSI インストーラはパス内の領域を無視します。この MSI プロパティはオプションです。	%ProgramFiles%\VMware\VMware View\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 7 でのリモートデスクトップ機能の構成ドキュメントの「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_FLASH_URL_REDIRECTION	Horizon Agent で Flash URL リダイレクト機能をインストールできるかどうかを特定します。1 を指定するとインストールが有効になり、0 を指定するとインストールが無効になります。この MSI プロパティはオプションです。	0
VDM_FORCE_DESKTOP_AGENT	Windows Server マシンに Horizon Agent をインストールし、RDS ホストではなくシングルユーザーの Horizon 7 デスクトップとして構成する場合は、値を 1 に設定します。この要件は、vCenter Server によって管理されるマシンと管理対象外のマシンに適用されます。アプリケーションセッションをホストするサーバ以外の Windows ゲストの場合は、値を 0 に設定します。この MSI プロパティはオプションです。	0

サイレントインストールコマンドでは、ADDLOCAL プロパティを使用して、Horizon Agent インストーラが設定するオプションを指定できます。

次の表は、コマンドラインで入力できる Horizon Agent オプションを示しています。これらのオプションには対応するセットアップオプションがあり、それらのオプションはインタラクティブインストールで選択解除または選択できます。

カスタムセットアップオプションの詳細については、Horizon Agent カスタムセットアップオプションを参照してください。

コマンドラインで ADDLOCAL プロパティを使用しない場合、Horizon Agent はインタラクティブなインストール時にデフォルトでインストールされるすべてのオプションをインストールします（ゲスト OS でサポートされている場合）。ADDLOCAL=ALL を使用すると、Horizon Agent は次のオプションを、デフォルトでオンのものもオフのものもすべてインストールします（NGVC を除き、ゲスト OS でサポートされている場合）。NGVC と SVIAgent は相互に排他的です。NGVC をインストールするには、明示的に指定する必要があります。

詳細については、Microsoft Windows インストーラコマンドラインオプションで ADDLOCAL 表の項目を参照してください。

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-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"

次の例では、Thinprint を VMware 印刷機能に置き換えることで、エージェントのインストールを変更しています。VMware-Horizon-Agent-x86-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=PrintRedir REMOVE=ThinPrint"

次の例では、シリアルポートとスキャナリダイレクトを追加することで、エージェントのインストールを変更しています。VMware-Horizon-Agent-x86-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection"

表 2. Horizon Agent のサイレントインストールオプションとインタラクティブカスタムセットアップオプション
サイレントインストールオプション	対話的なインストールのカスタムセットアップオプション	インタラクティブなインストール時にデフォルトでインストールされる、または ADDLOCAL が使用されていない場合にインストールされる
Core	Core	はい
USB	USB リダイレクト	いいえ
SVIAgent	View Composer Agent	はい
NGVC	Instant Clone Agent	いいえ
RTAV	リアルタイムオーディオビデオ	はい
ClientDriveRedirection	クライアントドライブリダイレクト	はい
SerialPortRedirection	シリアルポートリダイレクト	いいえ
ScannerRedirection	スキャナリダイレクト	いいえ
FlashURLRedirection	Flash URL リダイレクトこの機能は、コマンドラインで VDM_FLASH_URL_REDIRECTION=1 プロパティを使用しない限り非表示になっています。	いいえ
FLASHMMR	Flash リダイレクト	いいえ
GEOREDIR	位置情報リダイレクト	いいえ
ThinPrint	仮想印刷	はい
V4V	vRealize Operations Desktop Agent	はい
VPA	View Persona Management	はい
SmartCard	PCoIP スマートカードインタラクティブなインストールで、この機能がデフォルトでインストールされることはありません。	いいえ
VmwVaudio	VMware オーディオ（仮想オーディオドライバ）	はい
VmVideo	VMware Video（仮想ビデオドライバ）	いいえ
VmwVidd	VMware Indirect Display Driver	はい
TSMMR	Windows Media マルチメディアリダイレクト (MMR)	はい
RDP	コマンドラインの RDP_CHOICE=1 プロパティを使用するか、デスクトッププールを作成または編集する際にデフォルトの表示プロトコルとして RDP を選択する場合に、レジストリの RDP を有効にします。この機能はインタラクティブなインストールでは非表示になっています。	はい
VMWMediaProviderProxy	VMware Virtualization Pack for Skype for Business	いいえ
RDSH3D	RDS ホストでの 3D レンダリング	いいえ
BlastUDP	Blast の UDP 転送サポート	はい
HTML5MMR	HTML5 マルチメディアリダイレクト	いいえ
CIT（64 ビットのみ）	クライアント IP アドレスの透過性。 64 ビットのインストーラにのみ存在します。32 ビットインストーラを使用してコマンドラインから機能をインストールすると、MSI がエラーを返します。	いいえ
SdoSensor	SDO センサーのリダイレクト	いいえ
PerfTracker	Horizon Performance Tracker	いいえ
HelpDesk	Horizon Help Desk Tool	いいえ
PrintRedir	VMware Integrated Printing	いいえ

ADDLOCAL を使用して機能を個々に指定する場合、つまり ADDLOCAL=ALL を指定しない場合は、Core を常に指定する必要があります。

表 3. 自動的にインストールされる Horizon Agent サイレントインストール機能
サイレントインストール機能	説明
Core	Horizon Agent の主要機能。 ADDLOCAL=ALL を指定すると、Core 機能がインストールされます。
BlastProtocol	VMware Blast
PCoIP	PCoIP プロトコルエージェント
VmVideo	仮想ビデオドライバ
UnityTouch	Unity Touch
PSG	この機能は、Horizon Agent が IPv4 または IPv6 を使用しているかどうかを、Connection Server に伝えるレジストリエントリを設定します。

サイレントインストールで VDM_FLASH_URL_REDIRECTION=1 プロパティを使用することによって、Flash URL リダイレクト機能をインストールします。この機能は、インタラクティブなインストールでも、サイレントインストールで ADDLOCAL=ALL を使用した場合でもインストールされません。例：

VMware-Horizon-Agent-x86-y.y.y-xxxxxx.exe /s /v"/qn VDM_VC_MANAGED_AGENT=1 VDM_FLASH_URL_REDIRECTION=1 ADDLOCAL=Core,SVIAgent,ThinPrint,USB,FlashURLRedirection,RTAV"