コマンドラインによるVDAのインストール

はじめに

この記事は、Windowsオペレーティングシステムを搭載したマシンでのVirtual Delivery Agent (VDA) のインストール、アップグレード、およびカスタマイズに適用されます。

この記事では、VDAインストールコマンドの発行方法について説明します。インストールを開始する前に、VDAのインストールを確認し、インストールの考慮事項、インストーラー、およびインストール中に指定する内容について学習してください。

コマンドラインからのVDAのインストール

-  VDAをインストールし（コマンド実行の進行状況と戻り値を確認するため）、管理者権限を昇格させるか、**管理者として実行** を使用する必要があります。

-  1.  VDAをインストールするマシンで、[Citrix Cloud](https://citrix.cloud.com) にサインインします。

左上のメニューで、ソリューション > DaaS を選択します。

1. 右上で、ダウンロード をクリックし、VDAのダウンロード を選択します。 VDAダウンロードページにリダイレクトされます。目的のVDAインストーラーを見つけて、ファイルのダウンロード をクリックします。

ダウンロードが完了したら、その名前を実行します。この記事で説明されているオプションを使用します。

マルチセッションOS Virtual Delivery Agentの場合は、VDAServerSetup.exe を実行します。
シングルセッションOS Virtual Delivery Agentの場合は、VDAWorkstationSetup.exe を実行します。
シングルセッションOS Core Services Virtual Delivery Agentの場合は、VDAWorkstationCoreSetup.exe を実行します。

ファイルをインストールする前に抽出するには、絶対パスを指定して /extract を使用します。例：.\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia。（ディレクトリが存在している必要があります。存在しない場合、抽出は失敗します。）次に、別のコマンドで、この記事に記載されている有効なオプションを使用して、適切なコマンドを実行します。

-  `VDAServerSetup_XXXX.exe` の場合は、`<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe` を実行します。

-  `VDAWorkstationCoreSetup_XXXX.exe` の場合は、`<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe` を実行します。

VDAWorkstationSetup_XXXX.exe の場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe を実行します。

VDAをインストールするためのコマンドラインオプション

以下のオプションは、次の1つ以上のコマンドで有効です。VDAServerSetup.exe、VDAWorkstationSetup.exe、および VDAWorkstationCoreSetup.exe。

/components コンポーネント[,コンポーネント]

インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。

VDA: Virtual Delivery Agent
PLUGINS: Citrix Workspace™ アプリ for Windows
VDAとCitrix Workspaceアプリをインストールするには、/components vda,plugins を指定します。

plugins オプションを省略した場合、VDAのみがインストールされます（Citrix Workspaceアプリはインストールされません）。

このオプションは、VDAWorkstationCoreSetup.exe インストーラーを使用する場合は無効です。このインストーラーはCitrix Workspaceアプリをインストールできません。

/controllers “コントローラー [コントローラー]…”

VDAが通信できるCitrix Cloud Connectorのスペース区切りFQDNを、引用符で囲んで指定します。/site_guid オプションと /controllers オプションの両方を指定しないでください。
/disableexperiencemetrics
インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。

/enable_hdx_ports

Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、VDAおよび有効な機能（Windowsリモートアシスタンスを除く）に必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、ネットワークポートを参照してください。

HDXアダプティブトランスポートが使用するUDPポートを開くには、/enable_hdx_ports オプションに加えて、/enable_hdx_udp_ports オプションを指定します。

/enable_hdx_udp_ports

Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、HDXアダプティブトランスポートが必要とするWindowsファイアウォールのUDPポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、ネットワークポートを参照してください。

VDAが使用するポートを開くには、/enable_hdx_udp_ports オプションに加えて、/enable_hdx_ports オプションを指定します。
/enable_real_time_transport
オーディオパケットにUDPを使用する機能（オーディオ用のRealTime Audio Transport）を有効または無効にします。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。Windowsファイアウォールサービスが検出されたときにUDPポートを自動的に開く場合は、/enable_hdx_ports オプションを含めます。
/enable_remote_assistance

監視機能で使用するために、Windowsリモートアシスタンスのシャドウイング機能を有効にします。このオプションを指定すると、Windowsリモートアシスタンスはファイアウォール内の動的ポートを開きます。

/enablerestore または /enablerestorecleanup

（シングルセッションVDAのみ有効）VDAのインストールまたはアップグレードが失敗した場合に、復元ポイントへの自動復帰を有効にします。

インストール/アップグレードが正常に完了した場合：

/enablerestorecleanup は、インストーラーに復元ポイントを削除するよう指示します。
/enablerestore は、インストーラーに復元ポイントが使用されなかった場合でも保持するよう指示します。

詳細については、インストールまたはアップグレードの失敗時の復元を参照してください。

/enable_ss_ports
Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、画面共有に必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。
/exclude “component”[,”component”]
1つまたは複数のコンマ区切りのオプションコンポーネントのインストールを防止します。各コンポーネントは二重引用符で囲む必要があります。たとえば、MCS管理イメージにVDAをインストールまたはアップグレードする場合、Machine Identity Serviceコンポーネントが必要です。有効な値は次のとおりです。
Machine Identity Service
Citrix Profile Management
Citrix Profile Management WMI Plug-in
Citrix Personalization for App-V - VDA
Citrix MCS IODriver
Citrix VDA Upgrade Agent
Citrix Rendezvous V2

Citrix Profile Managementをインストールから除外する（/exclude "Citrix Profile Management"）と、MonitorコンソールからのVDAの監視とトラブルシューティングに影響します。User detailsページおよびEndPointページでは、PersonalizationパネルとLogon Durationパネルが失敗します。DashboardページおよびTrendsページでは、Average Logon DurationパネルはProfile Managementがインストールされているマシンのみのデータを表示します。

サードパーティのProfile Managementソリューションを使用している場合でも、CitrixはCitrix Profile Management Serviceをインストールして実行することを推奨します。Citrix Profile Management Serviceを有効にする必要はありません。

MCSを使用してVMをプロビジョニングする予定がある場合は、Machine Identity Serviceを除外しないでください。

/excludeと/includeadditionalの両方を同じコンポーネント名で指定した場合、そのコンポーネントはインストールされません。

このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。このインストーラーは、これらの項目の多くを自動的に除外します。

/h または /help

コマンドヘルプを表示します。

/includeadditional “component”[,”component”] …

1つまたは複数のコンマ区切りのオプションコンポーネントのインストールを含めます。各コンポーネントは二重引用符で囲む必要があります。コンポーネント名は大文字と小文字を区別します。

このオプションは、Remote PC Access展開を作成し、デフォルトで含まれていないコンポーネントをインストールしたい場合に役立ちます。有効な値は次のとおりです。

Citrix Profile Management
Citrix Profile Management WMI Plug-in
Citrix Personalization for App-V - VDA
Citrix MCS IODriver
Citrix VDA Upgrade Agent
Citrix Rendezvous V2
User personalization layer
Citrix Web Socket VDA Registration Tool

/excludeと/includeadditionalの両方を同じコンポーネント名で指定した場合、そのコンポーネントはインストールされません。

/installdir directory

コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。

/install_mcsio_driver

使用しないでください。代わりに、/includeadditional "Citrix MCS IODriver"または/exclude "Citrix MCS IODriver"を使用してください。

/logpath path

ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーはフォルダーを作成しません。デフォルト = “%TEMP%\Citrix\XenDesktop Installer”

このオプションはグラフィカルインターフェイスでは利用できません。

/masterimage

VDAをVMにインストールする場合にのみ有効です。VDAをイメージとしてセットアップします。このオプションは/mastermcsimageと同等です。

このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。

/mastermcsimage

このマシンがMachine Creation Servicesのイメージとして使用されることを指定します。このオプションは/masterimageと同等です。

/masterpvsimage

このマシンがCitrix Provisioning™またはサードパーティのプロビジョニングツール（Microsoft System Center Configuration Managerなど）のイメージとして使用されることを指定します。

/no_mediafoundation_ack

Microsoft Media Foundationがインストールされていないこと、およびいくつかのHDX™マルチメディア機能がインストールされず、動作しないことを確認します。このオプションを省略し、Media Foundationがインストールされていない場合、VDAのインストールは失敗します。サポートされているほとんどのWindowsエディションには、Nエディションを除き、Media Foundationがすでにインストールされています。

/nodesktopexperience

マルチセッションOS VDAをインストールする場合にのみ有効です。Enhanced Desktop Experience機能の有効化を防止します。この機能は、Enhanced Desktop Experience Citrixポリシー設定でも制御されます。

/noreboot

インストール後の再起動を防止します。VDAは再起動するまで使用できません。

/noresume

デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。このデフォルトを上書きするには、/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。

/portnumber port

/reconfigオプションが指定されている場合にのみ有効です。VDAとController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。

/proxyconfig “address or PAC file path”

コマンドに/includeadditional "Citrix Rendezvous V2"が含まれている場合にのみ有効です。Rendezvousプロトコルで使用するプロキシのアドレスまたはPACファイルパス。機能の詳細については、Rendezvousプロトコルを参照してください。

プロキシアドレス形式: http://<url-or-ip>:<port>
PACファイル形式: http://<url-or-ip>:<port>/<path>/<filename>.pac

/quiet または /passive

インストール中にユーザーインターフェイスは表示されません。インストールおよび構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。

/reconfigure

/portnumber、/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成されたVDA設定をカスタマイズします。このオプションを/quietオプションを指定せずに指定すると、VDAをカスタマイズするためのグラフィカルインターフェイスが起動します。

/remotepc

Remote PC Access展開（シングルセッションOS）またはブローカー接続（マルチセッションOS）の場合にのみ有効です。

このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。このインストーラーは、これらのコンポーネントのインストールを自動的に除外します。

/remove_appdisk_ack

インストールされている場合、AppDisks™ VDAプラグインをアンインストールする権限をVDAインストーラーに付与します。

/remove_pvd_ack

インストールされている場合、Personal vDiskをアンインストールする権限をVDAインストーラーに付与します。

/remove

/componentsオプションで指定されたコンポーネントを削除します。

/removeall

VDAを削除します。Citrix Workspaceアプリ（インストールされている場合）は削除しません。

/sendexperiencemetrics

インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合（または/disableexperiencemetricsオプションが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。

/servervdi

サポートされているWindowsサーバーにシングルセッションOS VDAをインストールします。WindowsサーバーにマルチセッションVDAをインストールする場合は、このオプションを省略します。このオプションを使用する前に、「サーバーVDI」を参照してください。

/site_guid guid

サイトのActive Directory組織単位（OU）のグローバル一意識別子。これは、Active Directoryを検出に使用する場合（自動更新が推奨されるデフォルトの検出方法です）に、仮想デスクトップをサイトに関連付けます。サイトGUIDは、Studioに表示されるサイトプロパティです。/site_guidオプションと/controllersオプションの両方を指定しないでください。

/tempdir directory

インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。

このオプションは、グラフィカルインターフェイスでは使用できません。

/virtualmachine

VDAをVMにインストールする場合にのみ有効です。BIOS情報がVMに渡されることで物理マシンとして表示される場合、インストーラーによる物理マシンの検出を上書きします。

このオプションは、グラフィカルインターフェイスでは使用できません。

/xendesktopcloud

VDAがCitrix DaaS（Citrix Cloud™）展開にインストールされていることを示します。

VDAのインストール例

マルチセッションOSへのVDAのインストール 次のコマンドは、マルチセッションOSにVDAをインストールします。

VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage

VDAはイメージとして使用されます。

マルチセッションOS VDAまたはシングルセッションOS VDAのインストール 次のコマンドは、マルチセッションOS VDAまたはシングルセッションOS VDAをインストールします。

VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot

各デリバリーコントローラー™のFQDNをコンマで区切ります。XXXXはVDAのバージョンを表します。

シングルセッションOSへのコアサービスVDAのインストール 次のコマンドは、Remote PC AccessまたはVDA展開で使用するために、シングルセッションOSにコアサービスVDAをインストールします。

VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

Citrix Workspaceアプリおよびその他の非コアサービスはインストールされません。Cloud Connectorのアドレスが指定され、Windowsファイアウォールサービスのポートが自動的に開かれます。管理者が再起動を処理します。

コマンドラインを使用したVDAのカスタマイズ

VDAをインストールした後、いくつかの設定をカスタマイズできます。次の1つ以上のオプションを使用して、XenDesktopVDASetup.exeを実行します。

/reconfigure（VDAをカスタマイズする際に必須）

/h または /help

/quiet

/noreboot

/controllers

/portnumber port

/enable_hdx_ports

この情報は役に立ちましたか?