Citrix Virtual Apps and Desktops

コマンドラインを使用したインストール

August 29, 2026

寄稿者:

C C

重要：

アップグレード中で、現在のバージョンでPersonal vDiskまたはAppDisksソフトウェアが使用されているか、インストールされている場合は、「PvD、AppDisks、およびサポートされていないホストの削除」を参照してください。

Citrixは、ライセンスコンプライアンスを含む正当な利益のために、必要に応じて基本的なライセンスデータを収集します。詳しくは、「Citrixライセンスデータ」を参照してください。

はじめに

この記事は、Windowsオペレーティングシステムを搭載したマシンへのコンポーネントのインストールに適用されます。Linuxオペレーティングシステム用VDAについては、「Linux Virtual Delivery Agent」を参照してください。

この記事では、製品のインストールコマンドの発行方法について説明します。インストールを開始する前に、「インストールの準備」を確認してください。この記事には、利用可能なインストーラーの説明が含まれています。

コマンドの実行状況と戻り値を確認するには、元の管理者であるか、管理者として実行を使用する必要があります。詳しくは、Microsoftのコマンドに関するドキュメントを参照してください。

インストールコマンドを直接使用することに加えて、Active Directory内のマシンにVDAをインストール、アップグレード、または削除するサンプルスクリプトが製品ISOに用意されています。詳しくは、「スクリプトを使用したVDAのインストール」を参照してください。

このCitrix Virtual Apps and DesktopsバージョンでサポートされていないWindows OSバージョンにインストールまたはアップグレードしようとすると、オプションに関する情報を示すメッセージが表示されます。「以前のオペレーティングシステム」を参照してください。

Citrixがコンポーネントのインストール結果を報告する方法については、「Citrixインストールのリターンコード」を参照してください。

製品版インストーラーを使用する

製品版インストーラーのコマンドラインインターフェイスにアクセスするには：

Citrixから製品パッケージをダウンロードします。ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
ファイルを解凍します。必要に応じて、ISOファイルをDVDに書き込みます。
コンポーネントをインストールするサーバーに、ローカル管理者アカウントを使用してログオンします。
DVDをドライブに挿入するか、ISOファイルをマウントします。
メディアの\x64\XenDesktop Setupディレクトリから、適切なコマンドを実行します。

コアコンポーネントをインストールするには： コアコンポーネントをインストールするためのコマンドラインオプションに記載されているオプションを使用して、XenDesktopServerSetup.exeを実行します。

VDAをインストールするには： VDAをインストールするためのコマンドラインオプションに記載されているオプションを使用して、XenDesktopVDASetup.exeを実行します。

StoreFrontをインストールするには： インストールメディアのx64 > StoreFrontフォルダーでCitrixStoreFront-x64.exeを実行します。

Universal Print Serverをインストールするには： Universal Print Serverをインストールするためのコマンドラインオプションのガイダンスに従ってください。

Federated Authentication Serviceをインストールするには： Citrixはグラフィカルインターフェイスの使用を推奨しています。

Session Recordingをインストールするには： Session Recordingのガイダンスに従ってください。

Workspace Environment Managementをインストールするには： Workspace Environment Managementのガイダンスに従ってください。

Secure Private Accessをインストールするには： インストールメディアのx64 > XenDesktop SetupフォルダーでXenDesktopSPASetup.exeを実行します。Secure Private Accessをインストールするためのコマンドラインオプションのガイダンスに従ってください。

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

XenDesktopServerSetup.exeコマンドでコアコンポーネントをインストールする場合、以下のパラメーターオプションが有効です。オプションの詳細については、コアコンポーネントのインストールを参照してください。

注：

コアコンポーネントをインストールするためのコマンドラインオプションを使用している間は、/excludeを使用しないでください。

/components を使用して 1 つのコンポーネントをアップグレードすると、他のコンポーネントもアップグレードされる場合があります。これは、異なるコンポーネント間の互換性の問題を回避するためです。

1 つのコンポーネントのみをアップグレードする場合は、そのコンポーネントの個別のインストーラーを使用してください。「展開のアップグレード」(/ja-jp/citrix-virtual-apps-desktops/upgrade-migrate/upgrade.html) を参照してください。

/ceipoptin ceipoptin [,ceipoptin] など.

Call Home データとカスタマーエクスペリエンス向上プログラム (CEIP) データの収集を有効にします。有効な値は次のとおりです。
- DIAGNOSTIC: Citrix Licensing が Call Home データを収集できるようにするには、この値を選択します。
- ANONYMOUS: Citrix Licensing が未識別の CEIP データ (ユーザーを特定しないデータ) を収集できるようにするには、この値を選択します。
- NONE: Citrix Licensing による CEIP データの収集を無効にするには、この値を選択します。
Call Home データ収集の詳細については、「Citrix Licensing Call Home」(/ja-jp/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-call-home) を参照してください。

CEIP データ収集の詳細については、「Citrix Licensing Customer Experience Improvement Program」(/ja-jp/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-customer-experience-improvement-program) を参照してください。

CEIP データの詳細については、「Citrix Licensing CEIP データ要素」(/ja-jp/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-ceip-data-elements) を参照してください。

License Server のライセンスデータの詳細については、「Citrix Licensing Data」(/ja-jp/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-compliance) を参照してください。
/components component [,component] など.

インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
- CONTROLLER: コントローラー
- DESKTOPSTUDIO: スタジオ
- WEBSTUDIO: ウェブスタジオ
- DESKTOPDIRECTOR: ディレクター
- LICENSESERVER: Citrix ライセンスサーバー
- SECUREPRIVATEACCESS: セキュアプライベートアクセス

VDA のみをインストールし、他の Citrix コンポーネントのインストールを除外するには、/components vda を指定します。

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

このオプションを省略すると、すべてのコンポーネントがインストールされます (/remove オプションも指定されている場合は、削除されます)。

(2003より前のリリースでは、有効な値には STOREFRONT™ が含まれていました。バージョン2003以降では、Use the full-product installer に記載されている専用のStoreFrontインストールコマンドを使用してください)。

前提条件のみ

選択したコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
/configure_firewall

Windowsファイアウォールサービスが実行されている場合、ファイアウォールが有効になっていなくても、インストールされているコンポーネントによって使用されるWindowsファイアウォール内のすべてのポートを開きます。サードパーティのファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ポートを手動で開く必要があります。
エクスペリエンスメトリックを無効にする

インストール、アップグレード、または削除中に収集された分析のCitrixへの自動アップロードを防止します。
/help または /h

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

ハードウェアチェックが失敗した場合でも（たとえば、RAM不足のため）、Delivery Controllerのインストールまたはアップグレードを続行できるようにします。詳細については、「ハードウェアチェック」を参照してください。
/ignore_site_test_failure

Controllerのアップグレード中にのみ有効です。通常、サイトテストの失敗は無視され、アップグレードは続行されます。省略された場合（またはfalseに設定された場合）、サイトテストの失敗があると、アップグレードを実行せずにインストーラーが失敗します。デフォルト = false

アップグレード中に、サポートされていないSQL Serverバージョンが検出された場合、このオプションは無視されます。詳細については、「SQL Serverのバージョンチェック」を参照してください。
/installdir ディレクトリ

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

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

Directorのインストール時にのみ有効です。Windowsリモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
/再起動なし

インストール後の再起動を防止します。（ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。）
/再開なし

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

Controller をインストールするサーバーへの Microsoft SQL Server Express のインストールを防止します。このオプションを省略すると、SQL Server Express がサイトデータベースとして使用するためにインストールされます。

このオプションは、ローカルホストキャッシュに使用される SQL Server Express LocalDB のインストールには影響しません。
/サイレント または /パッシブ

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

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

インストールされているすべてのコアコンポーネントを削除します。
/エクスペリエンスメトリックを送信

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

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

MSIMutexがタイムアウトするまでに解放されるのを待つ分数（デフォルトは3分）、有効な範囲は0から60分の間の整数（例：15、30、45）。

コアコンポーネントのインストール例

次のコマンドは、サーバーにDelivery Controller™、Studio、Citrix Licensing、およびSQL Server Expressをインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

次のコマンドは、サーバーにCitrix Virtual Apps™ Controller、Studio、およびSQL Server Expressをインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall

次のコマンドは、サーバーにDelivery Controller、Secure Private Access、およびSQL Server Expressをインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。

\x64\XenDesktop Setup XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall

Citrix Virtual Apps and Desktopsバージョン2407から2411以降にアップグレードする場合、またはバージョン2411以降の新規インストールを実行する場合は、最初のステップとしてライセンスサーバーを最新バージョン（バージョン11.2.17ビルド51000）に更新します。次に、Delivery Controllerをアップグレードします。これを怠ると、コマンドラインによるインストールとアップグレードが失敗します。ライセンスサーバーと、Delivery Controller、Web Studio、Citrix Directorなどのコンポーネントをアップグレードするには、次のコマンドを実行します（マウントされたISOの\x64フォルダー内にいると仮定します）。

次を実行します。
```
\x64\Licensing\CitrixLicensing.exe /quiet

```
ライセンスバイナリをローカルドライブのいずれかにコピーした場合は、次のコマンドを実行します。
```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log

```

次を実行します。

\x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
<!--NeedCopy-->

スタンドアロンVDAインストーラーを使用する

ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。インストールを開始する前に、管理者権限を昇格させるか、管理者として実行を使用する必要があります。

Citrixから適切なパッケージをダウンロードします。
- マルチセッションOS Virtual Delivery Agent: VDAServerSetup_xxxx.exe
- シングルセッションOS Virtual Delivery Agent: VDAWorkstationSetup_xxxx.exe
- シングルセッションOS Core Services Virtual Delivery Agent: VDAWorkstationCoreSetup_xxxx.exe
- 新しいシングルセッションOS Core Services Virtual Delivery Agent: VDASingleSessionCoreSetup_xxxx.exe
まずパッケージから既存のディレクトリにファイルを抽出し、その後インストールコマンドを実行するか、または単にパッケージを実行します。

ファイルをインストールする前に抽出するには、絶対パスを指定して/extractを使用します（例: C:\YourExtractFolder\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を実行します
- VDASingleSessionCoreSetup_XXXX.exeの場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\ XenDesktopSingleSessionCoreSetup.exeを実行します
- VDAWorkstationSetup_XXXX.exeの場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exeを実行します
ダウンロードしたパッケージを実行するには、その名前（VDAServerSetup.exe、VDAWorkstationSetup.exe、VDAWorkstationCoreSetup.exeまたはVDASingleSessionCoreSetup）を実行します。この記事に記載されている有効なオプションを使用してください。

フルプロダクトインストーラーに慣れている場合:

スタンドアロンのVDAServerSetup.exeまたはVDAWorkstationSetup.exeインストーラーを、その名前以外のすべてにおいてXenDesktopVdaSetup.exeコマンドであるかのように実行します。
VDAWorkstationCoreSetup.exeまたはVDASingleSessionCoreSetup.exeインストーラーは、他のインストーラーで利用可能なオプションのサブセットをサポートしているため、異なります。

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

以下のオプションは、次の1つ以上のコマンド（インストーラー）で有効です: VDAServerSetup_xxxx.exe、VDAWorkstationSetup_xxxx.exe、VDAWorkstationCoreSetup_xxxx.exe、およびVDASingleSessionCoreSetup_xxxx.exe。

オプションの詳細については、「VDAのインストール」を参照してください。

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

インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
- VDA: バーチャルデリバリーエージェント
- PLUGINS: Windows用 Citrix Workspaceアプリ
- CSA: Citrix Secure Accessクライアント
- UPL: シトリックスユーザーパーソナライゼーションレイヤー (WS VDAのみ)
- SRAGENT: セッションレコーディングエージェント
- ASSISTANTAPP: シトリックスバーチャルデスクトップアシスタント
- CEAL: シトリックスエラスティックアプリレイヤリング (TS VDAのみ)

2507 LTSR以降、Citrix Device Trust、Citrix uberAgent、およびCitrix Workspace Environment Management™ (WEM) Agentは、デフォルトのVDAインストールに統合されています。これらのコンポーネントはVDAセットアップの一部としてサイレントインストールされ、個別のコンポーネントとして管理されなくなりました。

注:

環境内で既存のスタンドアロン版Citrix uberAgent®が検出された場合、インストーラーによってインストール、アップグレード、またはアンインストールされることはありません。

一般的なコンポーネント選択の例:

WS VDAインストーラーですべてのサポート対象コンポーネントをインストールするには、/components VDA,PLUGINS,CSA,UPL,SRAGENT,ASSISTANTAPPを指定します。これは、WS VDAインストーラーの[コンポーネント]ページですべての利用可能なコンポーネントを選択することと同じです。
TS VDAインストーラーですべてのサポート対象コンポーネントをインストールするには、/components VDA,PLUGINS,CSA,CEAL,SRAGENT,ASSISTANTAPPを指定します。これは、TS VDAインストーラーの[コンポーネント]ページですべての利用可能なコンポーネントを選択することと同じです。
/componentsを省略すると、インストーラーはデフォルトでVDA、SRAGENT、およびASSISTANTAPPをインストールします。インストーラーのユーザーインターフェイスでは、これはVirtual Delivery Agent、Session Recording Agent、およびCitrix Virtual Desktop Assistantを選択することと同じです。
VDAとCitrix Workspace app for Windowsをインストールするには、/components VDA,PLUGINSを指定します。
VDAのみをインストールするには、/components VDAを指定します。これにより、Citrix Workspace app for Windowsおよびその他のコンポーネントは除外されます。

このオプションは、VDAWorkstationCoreSetup_xxxx.exeおよびVDASingleSessionCoreSetup_xxxx.exeインストーラーでは無効です。これらのインストーラーは、Citrix Workspace app for Windowsやその他のオプションコンポーネントをサポートしていません。

/前提条件のみ

選択したコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
/コントローラー “コントローラー [コントローラー]”

VDAが通信できるコントローラーのFQDNをスペースで区切り、引用符で囲みます。/site_guidオプションと/controllersオプションの両方を指定しないでください。
/エクスペリエンスメトリクスを無効にする

インストール、アップグレード、または削除中に収集された分析がCitrixに自動的にアップロードされるのを防ぎます。
/enable_hdx_ports

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

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

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

VDAが使用する追加のポートを開くには、この/enable_hdx_udp_portsオプションに加えて、/enable_hdx_portsオプションを指定します。
/enable_hdx_tls_dtls

HDX™ Direct V1用にTCPおよびUDPポート443を開きます。
/enable_real_time_transport

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

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

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

インストール/アップグレードが正常に完了した場合：
- /enablerestorecleanupは、インストーラーに復元ポイントを削除するよう指示します。
- /enablerestoreは、インストーラーに、使用されなかった場合でも復元ポイントを保持するよう指示します。
詳細については、「インストールまたはアップグレードの失敗時の復元」を参照してください。
/ENABLE_SECURE_DEFAULTS

より安全な初期設定のために、さまざまな機能のデフォルト設定を有効から無効に変更します。関連する機能は、クライアントドライブリダイレクト、特殊フォルダーリダイレクト、ドラッグアンドドロップ、クライアントTWAINデバイスリダイレクト、クライアントUSBプラグアンドプレイデバイスリダイレクト、クライアントプリンターリダイレクト、クライアントクリップボードリダイレクト、およびクライアントマイクのリダイレクトです。
/enable_ss_ports

Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、画面共有に必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。
/SKIPHDXDRIVERCHECK

VDAメタインストーラーへのHDX™ドライバーのチェックをスキップします。

/exclude “コンポーネント”[,”コンポーネント”]

1つまたは複数のコンマ区切りのオプションコンポーネント（それぞれを引用符で囲む）のインストールを防止します。たとえば、MCSによって管理されていないイメージにVDAをインストールまたはアップグレードする場合、Machine Identity Serviceコンポーネントは必要ありません。有効な値は次のとおりです。

マルチセッションOS	シングルセッションOS	シングルセッションOSコアサービス	新しいシングルセッションOSコアサービス
`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`
`Citrix Backup and Restore`	`Citrix Backup and Restore`
`Citrix deviceTRUST®`	`Citrix deviceTRUST`	`Citrix deviceTRUST`	`Citrix deviceTRUST`
`Citrix Secure Access Client`	`Citrix Secure Access Client`
`Citrix Workspace Environment Management™ Agent`	`Citrix Workspace Environment Management Agent`		`Citrix Workspace Environment Management Agent`
`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`
`Citrix MCS IODriver`	`Citrix MCS IODriver`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`
`Citrix Profile Management`	`Citrix Profile Management`		`Citrix Profile Management`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`		`Citrix Profile Management WMI Plug-in`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`	`Citrix Rendezvous V2`	`Citrix Rendezvous V2`
`Citrix Telemetry Service`	`Citrix Telemetry Service`	`Citrix Telemetry Service`	`Citrix Telemetry Service`
`Citrix Universal Print Client`	`Citrix Universal Print Client`	`Citrix Universal™ Print Client`	`Citrix Universal Print Client`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`		`Citrix VDA Upgrade Agent`
`CSE Component`	`CSE Component`	`CSE Component`	`CSE Component`
`Director VDA Plug-in`	`Director VDA Plug-in`	`Director VDA Plug-in`	`Director VDA Plug-in`
`Machine Identity Service`	`Machine Identity Service`
`Machine Management Provider`	`Machine Management Provider`	`Machine Management Provider`	`Machine Management Provider`
`Elastic App Layering`	`User Personalization Layer`
`VDA Monitor Plug-in`	`VDA Monitor Plug-in`	`VDA Monitor Plug-in`	`VDA Monitor Plug-in`
`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`
`Citrix App Protection Component`	`Citrix App Protection Component`	`Citrix App Protection Component`	`Citrix App Protection Component`
`Citrix HyperV Filter Driver`	`Citrix HyperV Filter Driver`	`Citrix Web Socket Vda Registration Tool`	`Citrix Web Socket Vda Registration Tool`
`App Packages Delivery Component`	`App Packages Delivery Component`	`App Packages Delivery Component`	`App Packages Delivery Component`
`Session Recording Agent`	`Session Recording Agent`
`Citrix Virtual Desktop Assistant`	`Citrix Virtual Desktop Assistant`

Citrix Profile Management をインストールから除外すると (/exclude "Citrix Profile Management")、Citrix Director を使用した VDA の監視とトラブルシューティングに影響します。ユーザーの詳細ページと EndPoint ページでは、パーソナライゼーションパネルとログオン期間パネルが機能しません。ダッシュボードページと トレンドページでは、平均ログオン期間パネルには、Profile Management がインストールされているマシンに関するデータのみが表示されます。

サードパーティのユーザープロファイル管理ソリューションを使用している場合でも、Citrix Profile Management Service をインストールして実行することをお勧めします。Citrix Profile Management Service を有効にする必要はありません。

Citrix Personalization for App-V – VDA は App Packages Delivery Component に名称変更され、Citrix Assistant App は Citrix Virtual Desktop Assistant に名称変更されました。

/components を使用してインストールできるコンポーネントは、そのコンポーネントを省略することで除外することもできます。たとえば、Citrix Secure Access Client、Session Recording Agent、および Citrix Virtual Desktop Assistant を除外するには、/components VDA を指定します。/components を指定しない場合は、/exclude を使用してこれらのコンポーネントを除外します。

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

/h または /help

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

/includeadditional “コンポーネント”[,”コンポーネント”]

1つまたは複数のコンマ区切りのオプションコンポーネントのインストールを含めます。各コンポーネントは二重引用符で囲みます。このオプションは、リモート PC アクセス展開を作成していて、デフォルトでは含まれていない他のコンポーネントをインストールしたい場合に役立ちます。有効な値は次のとおりです。

マルチセッションOS	シングルセッションOS
`Citrix Backup and Restore`	`Citrix Backup and Restore`
`Citrix MCS IODriver`	`Citrix MCS IODriver`
`App Packages Delivery Component`	`App Packages Delivery Component`
`Citrix Profile Management`	`Citrix Profile Management`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`Citrix Web Socket Vda Registration Tool`	`Citrix Web Socket Vda Registration Tool`
`VDA Token Enrollment`	`VDA Token Enrollment`

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

/installdir ディレクトリ

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

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

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

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

VM に VDA をインストールする場合にのみ有効です。VDA を他のマシンを作成するために使用するイメージとして設定します。このオプションは /mastermcsimage と同等です。

このオプションは、VDAWorkstationCoreSetup_xxxx.exe インストーラーを使用している場合は無効です。
/マスターMCSイメージ

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

このマシンが、Citrix Provisioning™ またはサードパーティのプロビジョニングツール (Microsoft System Center Configuration Manager など) を使用してVMをプロビジョニングするためのイメージとして使用されることを指定します。
/ウェブソケットトークン WebSocketToken

Web Socket VDAを作成します。WebSocketTokenは、必要なトークン用です。
/ウェブソケットトークンファイル WebSockトークンを含むファイル

Web Socket VDAを作成します。FileContainingWebSockToken は、必要なトークンを含むファイル用です。
/ウェブソケットトークン標準入力 <WebSocketToken

Web Socket VDAを作成します。<WebSocketToken は、STDINによって渡される必要なトークン用です。
/no_mediafoundation_ack

Microsoft Media Foundationがインストールされていないことを確認し、いくつかのHDXマルチメディア機能がインストールされず、動作しないことを承認します。このオプションが省略され、Media Foundationがインストールされていない場合、前提条件が満たされていないため、VDAのインストールは終了します。ほとんどのサポートされているWindowsエディションには、Nエディションを除き、Media Foundationがすでにインストールされています。Windows機能 > メディア機能を 手動で 有効にした場合、Citrix Meta Installerが探すレジストリキーに値が設定されていない可能性があります。インストールプロセスを開始する前に、SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion レジストリキーを確認して、値が存在し、空ではないことを確認してください。
/デスクトップエクスペリエンスなし

拡張デスクトップエクスペリエンス機能は利用できなくなりました。このオプション（およびポリシー設定）は、指定されても無視されます。

マルチセッションOS用VDAのインストール時にのみ有効です。拡張デスクトップエクスペリエンス機能の有効化を防止します。この機能は、拡張デスクトップエクスペリエンスCitrixポリシー設定でも制御されます。
/再起動なし

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

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

RemotePCインストールでは、/remotepcとともにこの引数を使用します。そうしないと、特定のユーザーシナリオでVDAが期待どおりに動作しない可能性があります。
/ポート番号 ポート

/reconfigオプションが指定されている場合にのみ有効です。VDAとController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。
/proxyconfig “アドレスまたはPACファイルのパス”

環境内でGateway ServiceなどのサービスとともにRendezvous V2プロトコルを使用する予定があり、アウトバウンド接続用にネットワークに非透過プロキシがある場合は、ここでプロキシを指定します。HTTPプロキシのみがサポートされています。Rendezvousプロトコルで使用するプロキシのアドレスまたはPACファイルパス。このコマンドラインは、/includeadditional “Citrix Rendezvous V2”が使用されたかのように、Citrix Rendezvous V2を自動的にインストールします。機能の詳細については、Rendezvous protocolを参照してください。
- プロキシアドレス形式: http://<url-or-ip>:<port>
- PACファイル形式: http://<url-or-ip>:<port>/<path>/<filename>.pac
/quiet または /passive

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

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

Remote PCアクセス展開（シングルセッションOS）またはブローカー接続（マルチセッションOS）の場合にのみ有効です。追加コンポーネントのインストールを除外します (/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。

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

/remotepcは/servervdiオプションと互換性がありません。
削除

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

インストールされている場合、VDAインストーラーがAppDisks™ VDAプラグインをアンインストールすることを承認します。
/remove_pvd_ack

インストールされている場合、VDAインストーラーがPersonal vDiskをアンインストールすることを承認します。
すべて削除

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

VDAとともにCWAを削除します。
/センドエクスペリエンスメトリクス

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

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

このオプションを使用する前に、「Server VDI」を参照してください。

このオプションは、フルプロダクトVDAインストーラーでのみ使用してください。
/site_guid GUID

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

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

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

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

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

MSIMutexが解放されるまで待機する分数（タイムアウトするまで）。デフォルトは3分で、有効な範囲は0～60分の整数です（例：15、30、45）。

VDAのインストール例

フルプロダクトインストーラーを使用したVDAのインストール:

次のコマンドは、シングルセッションOS用VDAとCitrix Workspaceアプリを、VMのデフォルトの場所にインストールします。このVDAはイメージとして使用され、MCSを使用してVMをプロビジョニングします。VDAは、mydomainドメイン内のContr-Mainという名前のサーバー上のControllerに最初に登録されます。VDAはユーザーパーソナライゼーションレイヤーとWindowsリモートアシスタンスを使用します。

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

VDAWorkstationCoreSetupスタンドアロンインストーラーを使用したシングルセッションOS VDAのインストール:

次のコマンドは、Remote PC AccessまたはVDI展開で使用するCore Services VDAをシングルセッションOSにインストールします。Citrix Workspaceアプリおよびその他のコア以外のサービスはインストールされません。Controllerのアドレスが指定され、Windowsファイアウォールサービス内のポートは自動的に開かれます。管理者が再起動を処理します。

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

VDAのカスタマイズ

VDAをインストールした後、いくつかの設定をカスタマイズできます。製品メディアの\x64\XenDesktop Setupディレクトリから、VDAインストール用のコマンドラインオプションで説明されている次のオプションの1つ以上を使用して、XenDesktopVdaSetup.exeを実行します。

/reconfigure（VDAをカスタマイズする際に必須）
/hまたは/help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports

VDA のトラブルシューティング

デリバリーグループのStudio表示では、詳細ペインのインストール済みVDAバージョンエントリが、マシンにインストールされているバージョンと異なる場合があります。マシンのWindowsのプログラムと機能の表示には、実際のVDAバージョンが表示されます。
VDAがインストールされた後、Delivery Controllerに登録されるまで、ユーザーにアプリやデスクトップを配信できません。

VDA登録方法と登録に関する問題のトラブルシューティングについては、VDA登録を参照してください。

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

次のオプションは、XenDesktopPrintServerSetup.exeコマンドで有効です。

/enable_upsserver_port

このオプションが指定されていない場合、インストーラーはグラフィカルインターフェイスからファイアウォールページを表示します。インストーラーにWindowsファイアウォールルールを自動的に追加させるには、自動を選択します。または、管理者がファイアウォールを手動で構成できるようにするには、手動を選択します。

プリントサーバーにソフトウェアをインストールした後、Citrix Universal Print Server (UPS)のガイダンスを使用してUniversal Print Serverを構成します。

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

次のオプションは、両方で有効です。

CVADインストーラー: XenDesktopSPASetup.exe
SPAオンプレミスインストーラー: SecurePrivateAccessSetup_XXXX.exe

/enable_spa_ports

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

Secure Private Access をインストールするサーバーへの Microsoft SQL Server Express のインストールを防止します。このオプションを省略すると、SQL Server Express がサイトデータベースとして使用するためにインストールされます。
ヘルプまたは /h または /?

コマンドヘルプを表示します
再起動なし

インストール後の再起動を防止します。Secure Private Access は再起動するまで使用できません。
サイレントまたは /パッシブ

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

Secure Private Access を削除します。

オプションの詳細については、Secure Private Access インストーラーを参照してください。

詳細情報

Citrix がコンポーネントのインストール結果を報告する方法については、Citrix インストールリターンコードを参照してください。

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

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

コマンドラインを使用したインストール

August 29, 2026

寄稿者:

C C

August 29, 2026

寄稿者:

C C

この記事の概要

はじめに
製品版インストーラーを使用する
コアコンポーネントをインストールするためのコマンドラインオプション
コアコンポーネントのインストール例
スタンドアロンVDAインストーラーを使用する
VDAをインストールするためのコマンドラインオプション
VDAのインストール例
VDAのカスタマイズ
VDA のトラブルシューティング
Universal Print Serverをインストールするためのコマンドラインオプション
Secure Private Accessをインストールするためのコマンドラインオプション
詳細情報

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