コマンドラインを使用したインストール
重要：
アップグレード中で、現在のバージョンでPersonal vDiskまたはAppDisksソフトウェアが使用されているかインストールされている場合は、「PvD、AppDisks、およびサポートされていないホストの削除」を参照してください。
Citrixは、ライセンスコンプライアンスを含む正当な利益のために、必要に応じて基本的なライセンスデータを収集します。詳しくは、「Citrixライセンスデータ」を参照してください。
はじめに
この記事は、Windowsオペレーティングシステムを搭載したマシンへのコンポーネントのインストールに適用されます。Linuxオペレーティングシステム用VDAについては、「Linux Virtual Delivery Agents」を参照してください。
この記事では、製品のインストールコマンドを発行する方法について説明します。インストールを開始する前に、「インストールの準備」を確認してください。この記事には、利用可能なインストーラーの説明が含まれています。
コマンド実行の進行状況と戻り値を確認するには、元の管理者であるか、管理者として実行を使用する必要があります。詳しくは、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 > XenDesktopSetupフォルダーにあるXenDesktopSPASetup.exeを実行します。「Secure Private Accessインストールのコマンドラインオプション」のガイダンスに従ってください。
-
Secure Private Accessをインストールするには：インストールメディアの
コアコンポーネントインストールのコマンドラインオプション
- `XenDesktopServerSetup.exe`コマンドでコアコンポーネントをインストールする場合、次のパラメーターオプションが有効です。オプションの詳細については、「[コアコンポーネントのインストール](/ja-jp/citrix-virtual-apps-desktops/install-configure/install-core-components)」を参照してください。
注：
- コアコンポーネントインストールのコマンドラインオプションを使用している間は、`/exclude`を使用しないでください。 - `/components`を使用して1つのコンポーネントをアップグレードすると、他のコンポーネントもアップグレードされる場合があります。これは、異なるコンポーネント間の潜在的な互換性の問題を回避するためです。
- 1つのコンポーネントのみをアップグレードする場合は、そのコンポーネントの個別のインストーラーを使用してください。「展開のアップグレード」を参照してください。
- **/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)」を参照してください。
ライセンスサーバーのライセンスデータの詳細については、「[Citrixライセンスデータ](/ja-jp/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-compliance)」を参照してください。
-
/components component [,component] …
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
CONTROLLER：コントローラー -
DESKTOPSTUDIO：Studio -
WEBSTUDIO：Web Studio -
DESKTOPDIRECTOR：Director -
LICENSESERVER：Citrixライセンスサーバー -
SECUREPRIVATEACCESS：Secure Private Access
-
VDAのみをインストールし、他のCitrixコンポーネントのインストールを除外するには、/components vdaを指定します。
このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合は無効です。このインストーラーは、Citrix Workspaceアプリまたはその他のCitrixコンポーネントをインストールできません。
このオプションを省略すると、すべてのコンポーネントがインストールされます（または、/removeオプションも指定されている場合は削除されます）。
（2003年より前のリリースでは、有効な値にSTOREFRONT™が含まれていました。バージョン2003以降では、「フルプロダクトインストーラーの使用」に記載されている専用のStoreFrontインストールコマンドを使用してください）。
-
/onlyprereqs
選択されたコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
-
/configure_firewall
Windowsファイアウォールサービスが実行されている場合、ファイアウォールが有効になっていなくても、インストールされるコンポーネントが使用するWindowsファイアウォールのすべてのポートを開きます。サードパーティ製ファイアウォールまたはファイアウォールを使用していない場合は、手動でポートを開く必要があります。
-
/disableexperiencemetrics
インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
-
/help または /h
コマンドのヘルプを表示します。
-
/ignore_hw_check_failure
ハードウェアチェックが失敗した場合（例：RAM不足のため）でも、Delivery Controllerのインストールまたはアップグレードを続行できるようにします。詳細については、「ハードウェアチェック」を参照してください。
-
/ignore_site_test_failure
Controllerのアップグレード中にのみ有効です。通常、サイトテストの失敗は無視され、アップグレードが続行されます。このオプションが省略された場合（またはfalseに設定された場合）、サイトテストの失敗があると、アップグレードを実行せずにインストーラーが失敗します。デフォルト = false
アップグレード中に、サポートされていないSQL Serverバージョンが検出された場合、このオプションは無視されます。詳細については、「SQL Serverバージョンチェック」を参照してください。
-
/installdir directory
コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
-
/logpath path
- ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト =
TEMP%\Citrix\XenDesktop Installer
- ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト =
-
/no_remote_assistance
-
Directorのインストール時にのみ有効です。Windowsリモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
-
/noreboot
-
インストール後の再起動を防ぎます。(ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。)
-
/noresume
-
デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。このデフォルトを上書きするには、
/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。 -
/nosql
Controllerをインストールしているサーバー上でのMicrosoft SQL Server Expressのインストールを防ぎます。このオプションが省略された場合、SQL Server Expressはサイトデータベースとして使用するためにインストールされます。
このオプションは、ローカルホストキャッシュに使用されるSQL Server Express LocalDBのインストールには影響しません。
- /quiet または /passive
インストール中にユーザーインターフェイスは表示されません。インストールプロセスの唯一の証拠はWindowsタスクマネージャーにあります。このオプションが省略された場合、グラフィカルインターフェイスが起動します。
-
-
/remove
-
/componentsオプションで指定されたコアコンポーネントを削除します。
-
-
/removeall
- インストールされているすべてのコアコンポーネントを削除します。
-
/sendexperiencemetrics
インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合（または
/disableexperiencemetricsが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。 -
/tempdir directory
インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
-
/xenapp
Citrix Virtual Appsをインストールします。このオプションが省略された場合、Citrix Virtual Apps and Desktops™がインストールされます。
-
コアコンポーネントのインストール例
以下のコマンドは、デリバリーコントローラー、Studio、Citrixライセンス、およびSQL Server Expressをサーバーにインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
以下のコマンドは、Citrix Virtual Apps™ コントローラー、Studio、およびSQL Server Expressをサーバーにインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。
\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
以下のコマンドは、デリバリーコントローラー、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）に更新します。その後、デリバリーコントローラーをアップグレードします。そうしないと、コマンドラインでのインストールとアップグレードが失敗します。ライセンスサーバーと、デリバリーコントローラー、Web Studio、Citrix Directorなどのコンポーネントをアップグレードするには、以下のコマンドを実行します（マウントされたISOの\x64フォルダー内にいることを前提としています）。
- 1. 以下を実行します。
```
\x64\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy--> ```
ライセンスバイナリをいずれかのローカルドライブにコピーした場合は、以下のコマンドを実行します。
```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```
-
以下を実行します。
\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向けコアサービスVirtual Delivery Agent:
VDAWorkstationCoreSetup_xxxx.exe
- マルチセッションOS向けVirtual Delivery Agent:
-
最初にパッケージからファイルを既存のディレクトリに抽出し、その後インストールコマンドを実行するか、単にパッケージを実行します。
ファイルをインストールする前に抽出するには、絶対パスを指定して
/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を実行します -
VDAWorkstationSetup_XXXX.exeの場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exeを実行します
ダウンロードしたパッケージを実行するには、
VDAServerSetup.exe、VDAWorkstationSetup.exe、またはVDAWorkstationCoreSetup.exeを実行します。この記事に記載されている有効なオプションを使用します。 -
フル製品インストーラーに精通している場合:
-
スタンドアロンの
VDAServerSetup.exeまたはVDAWorkstationSetup.exeインストーラーを、名前以外はXenDesktopVdaSetup.exeコマンドであるかのように実行します。 -
VDAWorkstationCoreSetup.exeインストーラーは、他のインストーラーで利用可能なオプションのサブセットをサポートしているため、異なります。
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
VDA: Virtual Delivery Agent -
CSA: Citrix Secure Access™ クライアント -
PLUGINS: Windows向けCitrix Workspace™アプリ -
UPL: Citrixユーザーパーソナライゼーションレイヤー（WS VDAのみ） -
SRAGENT: セッションレコーディングエージェント -
ASSISTANTAPP: Citrix Assistantアプリ（WS VDAのみ）-
CEAL: Citrix Elastic App Layering（TS VDAのみ）
-
VDAとWindows向けCitrix Workspaceアプリをインストールするには、/components vda,pluginsを指定するか、コンポーネントをまったく指定しません。
このバージョンから、Citrix Device Trust、Citrix uberAgent、およびCitrix Workspace Environment Management™ (WEM) エージェントは、デフォルトのVDAインストールに統合されています。これらのコンポーネントはVDAセットアップの一部としてサイレントインストールされ、個別のコンポーネントとして管理されなくなりました。
注: - > 環境内で既存のスタンドアロン版Citrix uberAgent®が検出された場合、インストーラーによってインストール、アップグレード、またはアンインストールされることはありません。
VDAのみをインストールし、他のCitrixコンポーネントのインストールを除外するには、/components vdaを指定します。
- このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合は無効です。そのインストーラーはCitrix Workspaceアプリや他のCitrixコンポーネントをインストールできません。
VDAインストール用コマンドラインオプション
以下のオプションは、VDAServerSetup_xxxx.exe、VDAWorkstationSetup_xxxx.exe、およびVDAWorkstationCoreSetup_xxxx.exeの1つ以上のコマンド（インストーラー）で有効です。
オプションの詳細については、VDAのインストールを参照してください。
-
/componentscomponent[,component]インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
VDA: Virtual Delivery Agent -
PLUGINS: Windows向けCitrix Workspaceアプリ -
CSA: Citrix Secure Accessクライアント -
UPL: Citrixユーザーパーソナライゼーションレイヤー（WS VDAのみ） -
SRAGENT: セッションレコーディングエージェント -
ASSISTANTAPP: Citrix Assistantアプリ（WS VDAのみ） -
CEAL: Citrix Elastic App Layering（TS VDAのみ）
-
-
VDAとWindows向けCitrix Workspaceアプリをインストールするには、
/components vda, plugins, CSA, UPLを指定するか、コンポーネントをまったく指定しません。コンポーネントが指定されていない場合、デフォルトではVDA、SRAGENT、およびASSISTANTAPPのみがインストールされます。 -
VDAのみをインストールし、Citrix Workspaceアプリやその他のコンポーネントのインストールを除外するには、
/components vdaを指定します。 -
このオプションは、
VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合には無効です。このインストーラーはCitrix Workspaceアプリをインストールできません。 -
/onlyprereqs
- 選択したコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
-
/controllers “controller [controller]”
-
VDAが通信できるControllerの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_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 “component”[,”component”]
1つまたは複数のコンマ区切りのオプションコンポーネントのインストールを防止します。各コンポーネントはストレート引用符で囲みます。たとえば、MCSによって管理されていないイメージにVDAをインストールまたはアップグレードする場合、Machine Identity Serviceコンポーネントは必要ありません。有効な値は次のとおりです。
マルチセッションOS シングルセッションOS シングルセッションOSコアサービス Citrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Backup and RestoreCitrix Backup and RestoreCitrix Browser Content Redirection -
Citrix deviceTRUST®Citrix deviceTRUSTCitrix deviceTRUSTuberAgent®uberAgentuberAgent -
Citrix Secure Access ClientCitrix Secure Access ClientCitrix Secure Access ClientCitrix Workspace Environment Management™ AgentCitrix Workspace Environment Management AgentCitrix Workspace Environment Management Agent -
Citrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Personalization for App-V - VDACitrix MCS IODriverCitrix MCS IODriverCitrix Telemetry Service -
Citrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Universal™ Print ClientCitrix Profile ManagementCitrix Profile ManagementCitrix Vda Log Capture Service -
Citrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCSE ComponentCitrix Rendezvous V2Citrix Rendezvous V2Director VDA Plug-in -
Citrix Telemetry ServiceCitrix Telemetry ServiceMachine Management ProviderCitrix Universal Print ClientCitrix Universal Print ClientCitrix Universal™ Print ClientCitrix Vda Log Capture ServiceCitrix Vda Log Capture ServiceVDA Monitor Plug-inCitrix VDA Upgrade AgentCitrix VDA Upgrade AgentVDA WMI Proxy Plug-inCSE ComponentCSE ComponentDirector VDA Plug-inDirector VDA Plug-inMachine Identity ServiceMachine Identity ServiceMachine Management ProviderMachine Management ProviderVDA Monitor Plug-inUser Personalization LayerVDA WMI Proxy Plug-inVDA Monitor Plug-inVDA WMI Proxy Plug-inCitrix App Protection ComponentCitrix App Protection ComponentCitrix App Protection ComponentCitrix HyperV Filter DriverCitrix HyperV Filter DriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Personalization for App-V - VDASession Recording AgentSession Recording AgentElastic App LayeringCitrix Assistant App
インストールからCitrix Profile Managementを除外する（/exclude "Citrix Profile Management"）と、Citrix Directorを使用したVDAの監視とトラブルシューティングに影響します。ユーザー詳細ページとエンドポイントページでは、パーソナライゼーションパネルとログオン期間パネルが機能しません。ダッシュボードページとトレンドページでは、平均ログオン期間パネルにProfile Managementがインストールされているマシンのみのデータが表示されます。
サードパーティのユーザープロファイル管理ソリューションを使用している場合でも、CitrixはCitrix Profile Management Serviceをインストールして実行することを推奨します。Citrix Profile Management Serviceを有効にする必要はありません。
同じコンポーネント名で /exclude と /includeadditional の両方を指定した場合、そのコンポーネントはインストールされません。
このオプションは、VDAWorkstationCoreSetup.exe インストーラーを使用する場合には無効です。このインストーラーは、これらの項目の多くを自動的に除外します。
-
/h または /help
コマンドのヘルプを表示します。
-
/includeadditional “component”[,”component”]
1つまたは複数のコンマ区切りのオプションコンポーネントのインストールを含めます。各コンポーネントは引用符で囲まれています。このオプションは、リモートPCアクセス展開を作成し、デフォルトで含まれていない他のコンポーネントをインストールする場合に役立ちます。有効な値は次のとおりです。
マルチセッションOS シングルセッションOS Citrix Backup and RestoreCitrix Backup and RestoreCitrix MCS IODriverCitrix MCS IODriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Profile ManagementCitrix Profile ManagementCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCitrix Rendezvous V2Citrix Rendezvous V2Citrix VDA Upgrade AgentCitrix VDA Upgrade AgentCitrix Web Socket Vda Registration ToolCitrix Web Socket Vda Registration ToolMachine Identity ServiceMachine Identity ServiceUser Personalization Layer同じコンポーネント名で
/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
VMにVDAをインストールする場合にのみ有効です。VDAを他のマシンを作成するために使用されるイメージとして設定します。このオプションは
/mastermcsimageと同等です。このオプションは
VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合は無効です。 -
/mastermcsimage
このマシンがMachine Creation Servicesのイメージとして使用されることを指定します。このオプションは
/masterimageと同等です。 -
/masterpvsimage
このマシンがCitrix Provisioning™またはサードパーティのプロビジョニングツール（Microsoft System Center Configuration Managerなど）を使用してVMをプロビジョニングするためのイメージとして使用されることを指定します。
-
/websockettoken WebSocketToken
Web Socket VDAを作成します。WebSocketTokenは、必要なトークン用です。
-
/websockettokenfile FileContainingWebSockToken
Web Socket VDAを作成します。FileContainingWebSockToken は、必要なトークンを含むファイル用です。
-
/websockettokenstdin <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レジストリキーをチェックして、値が存在し、空ではないことを確認してください。 -
/nodesktopexperience
拡張デスクトップエクスペリエンス機能は利用できなくなりました。このオプション（およびポリシー設定）は、指定されても無視されます。
マルチセッションOS用のVDAをインストールする場合にのみ有効です。拡張デスクトップエクスペリエンス機能の有効化を防止します。この機能は、拡張デスクトップエクスペリエンスCitrixポリシー設定でも制御されます。
-
/noreboot
インストール後の再起動を防止します。VDAは再起動後まで使用できません。
-
/noresume
デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。このデフォルトを上書きするには、
/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。 -
/physicalmachine
RemotePCインストールの場合、この引数を
/remotepcとともに使用します。そうしないと、特定のユーザーシナリオでVDAが期待どおりに動作しない可能性があります。 -
/portnumber port
/reconfigオプションが指定されている場合にのみ有効です。VDA とコントローラー間の通信を有効にするポート番号。以前に構成されたポートは、ポート 80 でない限り無効になります。 -
/proxyconfig“address or PAC file path”環境内で Gateway Service などのサービスと Rendezvous V2 プロトコルを使用する予定があり、ネットワークにアウトバウンド接続用の非透過型プロキシがある場合は、ここでプロキシを指定します。HTTP プロキシのみがサポートされます。Rendezvous プロトコルで使用するプロキシのアドレスまたは PAC ファイルパス。このコマンドラインは、
/includeadditional "Citrix Rendezvous V2"が使用されたかのように、Citrix Rendezvous V2 を自動的にインストールします。機能の詳細については、Rendezvous プロトコルを参照してください。- プロキシアドレス形式:
http://<url-or-ip>:<port> - PAC ファイル形式:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- プロキシアドレス形式:
-
/quietor/passiveインストール中にユーザーインターフェイスは表示されません。インストールおよび構成プロセスの唯一の証拠は、Windows タスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/reconfigure/portnumber、/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成された VDA 設定をカスタマイズします。このオプションを/quietオプションと同時に指定しない場合、VDA をカスタマイズするためのグラフィカルインターフェイスが起動します。 -
/remotepcRemote PC Access 展開 (シングルセッション OS) またはブローカー接続 (マルチセッション OS) の場合にのみ有効です。追加コンポーネントのインストールを除外します (
/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。このオプションは、
VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。このインストーラーは、これらのコンポーネントのインストールを自動的に除外します。/remotepcは/servervdiオプションと互換性がありません。 -
/remove/componentsオプションで指定されたコンポーネントを削除します。 -
/remove_appdisk_ackインストールされている場合、VDA インストーラーが AppDisks™ VDA プラグインをアンインストールすることを承認します。
-
/remove_pvd_ackインストールされている場合、VDA インストーラーが Personal vDisk をアンインストールすることを承認します。
-
/removeallVDA を削除します。Citrix Workspace アプリ (インストールされている場合) は削除しません。
-
/REMOVEALLWITHCWAVDA とともに CWA を削除します。
-
/sendexperiencemetricsインストール、アップグレード、または削除中に収集された分析データを Citrix に自動的に送信します。このオプションを省略した場合 (または
/disableexperiencemetricsオプションが指定された場合)、分析データはローカルで収集されますが、自動的には送信されません。 -
/servervdiサポートされている Windows マルチセッションマシンに、シングルセッション OS 用の VDA をインストールします。Windows マルチセッションマシンにマルチセッション OS 用の VDA をインストールする場合は、このオプションを省略します。
このオプションを使用する前に、Server VDI を参照してください。
このオプションは、フルプロダクト VDA インストーラーでのみ使用してください。
-
/site_guidguidサイトの Active Directory 組織単位 (OU) のグローバル一意識別子。これは、Active Directory を検出に使用している場合に、仮想デスクトップをサイトに関連付けます (自動更新が推奨されるデフォルトの検出方法です)。サイト GUID は、Studio に表示されるサイトプロパティです。
/site_guidオプションと/controllersオプションの両方を指定しないでください。 -
/tempdirdirectoryインストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
このオプションはグラフィカルインターフェイスでは使用できません。
-
/virtualmachineVM に VDA をインストールする場合にのみ有効です。VM に渡される BIOS 情報によって物理マシンとして表示される場合、インストーラーによる物理マシンの検出を上書きします。
このオプションはグラフィカルインターフェイスでは使用できません。
-
/xendesktopcloudVDA が Citrix DaaS (Citrix Cloud™) 展開にインストールされていることを示します。
VDAインストールの例
フルプロダクトインストーラーを使用したVDAのインストール:
次のコマンドは、シングルセッションOSおよびCitrix Workspaceアプリ用のVDAを、VM上のデフォルトの場所にインストールします。このVDAはイメージとして使用され、MCSを使用してVMをプロビジョニングします。VDAは最初に、mydomainドメイン内のContr-Mainという名前のサーバー上のControllerに登録されます。VDAはユーザーパーソナライゼーションレイヤーとWindowsリモートアシスタンスを使用します。
```
\x64\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy--> ```
VDAWorkstationCoreSetupスタンドアロンインストーラーを使用したシングルセッションOS VDAのインストール:
次のコマンドは、Remote PC AccessまたはVDI展開で使用するために、シングルセッションOSにコアサービスVDAをインストールします。Citrix Workspaceアプリおよびその他の非コアサービスはインストールされません。Controllerのアドレスが指定され、Windowsファイアウォールサービス内のポートは自動的に開かれます。管理者が再起動を処理します。
```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```
VDAのカスタマイズ
VDAをインストールした後、いくつかの設定をカスタマイズできます。製品メディアの\x64\XenDesktop SetupディレクトリからXenDesktopVdaSetup.exeを実行し、VDAインストールのコマンドラインオプションで説明されている次のオプションを1つ以上使用します。
-
/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ファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。
-
/nosql
Secure Private AccessをインストールするサーバーへのMicrosoft SQL Server Expressのインストールを防止します。このオプションを省略すると、SQL Server Expressがサイトデータベースとして使用するためにインストールされます。
-
/help or /h or /?
コマンドヘルプを表示します
-
/noreboot
インストール後の再起動を防止します。Secure Private Accessは、再起動後まで使用できません。
-
/quiet or /passive
インストール中にユーザーインターフェイスは表示されません。インストールおよび構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/remove
Secure Private Accessを削除します。
オプションの詳細については、「Secure Private Accessインストーラー」を参照してください。
詳細情報
Citrixがコンポーネントインストールの結果を報告する方法については、「Citrixインストールのリターンコード」を参照してください。