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

重要：

• アップグレード中で、現在のバージョンでPersonal vDiskまたはAppDisksソフトウェアが使用されているかインストールされている場合は、「Removing PvD, AppDisks, and unsupported hosts」を参照してください。

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

はじめに

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

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

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

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

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

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

フルプロダクトインストーラーを使用する

フルプロダクトインストーラーのコマンドラインインターフェイスにアクセスするには：

1. Citrixから製品パッケージをダウンロードします。ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
2. ファイルを解凍します。必要に応じて、ISOファイルをDVDに書き込みます。
3. コンポーネントをインストールするサーバーに、ローカル管理者アカウントを使用してログオンします。
4. DVDをドライブに挿入するか、ISOファイルをマウントします。

5. メディアの \x64\XenDesktop Setup ディレクトリから、適切なコマンドを実行します。

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

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

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

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

   フェデレーション認証サービスをインストールするには： Citrixではグラフィカルインターフェイスの使用を推奨しています。

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

   ワークスペース エンバイロメント マネジメント をインストールするには: ワークスペース エンバイロメント マネジメント のガイダンスに従ってください。

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

コアコンポーネントのインストール用コマンドラインオプション

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

注：

• コアコンポーネントのインストール用コマンドラインオプションを使用している間は、/exclude を使用しないでください。
• /componentsを使用して1つのコンポーネントをアップグレードすると、他のコンポーネントもアップグレードされる場合があります。これは、異なるコンポーネント間の潜在的な互換性の問題を回避するためです。
• 1つのコンポーネントのみをアップグレードする場合は、そのコンポーネントの個別のインストーラーを使用してください。「展開のアップグレード」(/ja-jp/citrix-virtual-apps-desktops/2511/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 ライセンス顧客体験向上プログラムを参照してください。

  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)を参照してください。

• /コンポーネント コンポーネント [,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製品コンポーネントはインストールされません。

• /コンフィギュア_ファイアウォール

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

• /ディスエーブルエクスペリエンスメトリクス

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

• /help or /h

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

• ハードウェアチェックの失敗を無視する

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

• サイトテスト失敗を無視

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

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

• インストールディレクトリ ディレクトリ

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

• /ログパス パス

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

• /リモートアシスタンスなし

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

• 再起動なし

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

• 再開なし

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

• SQLを使用しない

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

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

• /quiet or /passive

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

• 削除

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

• すべて削除

  インストールされているすべてのコアコンポーネントを削除します。

• エクスペリエンスメトリクス送信

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

• /tempdir ディレクトリ

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

• ゼナップ

  Citrix Virtual Apps をインストールします。このオプションを省略すると、Citrix Virtual Apps and Desktops™ がインストールされます。

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

次のコマンドは、サーバーに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以降の新規インストールを実行する場合は、最初のステップとしてLicense Serverを最新バージョン（バージョン11.2.17ビルド51000）に更新します。次に、Delivery Controllerをアップグレードします。これを怠ると、コマンドラインインストールとアップグレードが失敗します。License Serverと、Delivery Controller、Web Studio、Citrix Directorなどのコンポーネントをアップグレードするには、次のコマンドを実行します（マウントされたISOの\x64フォルダー内にいると仮定します）。

1. 次を実行します。

   \x64\Licensing\CitrixLicensing.exe /quiet
   <!--NeedCopy-->
   

   ライセンスバイナリをローカルドライブのいずれかにコピーした場合は、次のコマンドを実行します。

   \x64\Licensing\CitrixLicensing.exe /quiet /l install.log
   <!--NeedCopy-->
   

2. 次を実行します。

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

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

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

1. Citrixから適切なパッケージをダウンロードします。
   • マルチセッションOS バーチャル デリバリー エージェント: VDAServerSetup_xxxx.exe
   • シングルセッションOS バーチャル デリバリー エージェント: VDAWorkstationSetup_xxxx.exe
   • シングルセッションOS コアサービス バーチャル デリバリー エージェント: VDAWorkstationCoreSetup_xxxx.exe

2. まず、パッケージから既存のディレクトリにファイルを抽出し、その後インストールコマンドを実行するか、単にパッケージを実行します。

   ファイルをインストールする前に抽出するには、絶対パスを指定して /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: バーチャル デリバリー エージェント
• CSA: シトリックス セキュア アクセス™ クライアント
• PLUGINS: Windows向けシトリックス ワークスペース™ アプリ
• UPL: Citrixユーザーパーソナライゼーションレイヤー (WS VDAのみ)
• SRAGENT: セッションレコーディングエージェント
• ASSISTANTAPP: シトリックス アシスタント アプリ (WS VDAのみ)
• CEAL: シトリックス エラスティック アプリ レイヤリング (TS VDAのみ)

VDAとWindows向けCitrix Workspaceアプリをインストールするには、/components vda,plugins を指定するか、コンポーネントをまったく指定しないでください。

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

注：

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

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

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

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

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

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

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

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

  • VDA: バーチャル デリバリー エージェント
  • PLUGINS: Windows向けCitrixワークスペースアプリ
  • CSA: Citrix セキュアアクセス クライアント
  • UPL: Citrixユーザーパーソナライゼーションレイヤー (WS VDAのみ)
  • SRAGENT: セッションレコーディングエージェント
  • ASSISTANTAPP: Citrixアシスタントアプリ (WS VDAのみ)
  • CEAL: Citrix エラスティック アプリ レイヤリング (TS VDA のみ)

VDAとWindows向けCitrix Workspaceアプリをインストールするには、/components vda, plugins, CSA, UPLを指定するか、コンポーネントをまったく指定しないでください。コンポーネントが指定されていない場合、VDA、SRAGENT、およびASSISTANTAPPのみがデフォルトでインストールされます。

VDAのみをインストールし、Citrix Workspaceアプリおよびその他のコンポーネントのインストールを除外するには、/components vdaを指定します。

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

• 前提条件のみ

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

• コントローラー “コントローラー [コントローラー]”

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

• /ディスエイブルエクスペリエンスメトリクス

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

• /イネーブル_HDX_ポーツ

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

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

• /イネーブル_HDX_UDP_ポーツ

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

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

• /enable_hdx_tls_dtls

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

• /イネーブル_リアル_タイム_トランスポート

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

• /イネーブル_リモート_アシスタンス

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

• /イネーブルリストア または /イネーブルリストアクリーンアップ

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

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

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

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

• /セキュア_デフォルト_有効化

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

• /enable_ss_ports

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

• /SKIPHDXDRIVERCHECK

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

• /exclude “コンポーネント”<,”コンポーネント”>

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

  マルチセッション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 Backup and Restore	Citrix Backup and Restore	Citrix Browser Content Redirection
  Citrix deviceTRUST®	Citrix deviceTRUST	Citrix deviceTRUST
  uberAgent®	uberAgent	uberAgent
  Citrix Secure Access Client	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 Personalization for App-V - VDA
  Citrix MCS IODriver	Citrix MCS IODriver	Citrix Telemetry Service
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA	Citrix Universal™ Print Client
  Citrix Profile Management	Citrix Profile Management	Citrix Vda Log Capture Service
  Citrix Profile Management WMI Plug-in	Citrix Profile Management WMI Plug-in	CSE Component
  Citrix Rendezvous V2	Citrix Rendezvous V2	Director VDA Plug-in
  Citrix Telemetry Service	Citrix Telemetry Service	Machine Management Provider
  Citrix Universal Print Client	Citrix Universal Print Client	VDA Monitor Plug-in
  Citrix Vda Log Capture Service	Citrix Vda Log Capture Service	VDA WMI Proxy Plug-in
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  CSE Component	CSE Component
  Director VDA Plug-in	Director VDA Plug-in
  Machine Identity Service	Machine Identity Service
  Machine Management Provider	Machine Management Provider
  VDA Monitor Plug-in	User Personalization Layer
  VDA WMI Proxy Plug-in	VDA Monitor Plug-in
  	VDA WMI Proxy Plug-in
  Citrix App Protection Component	Citrix App Protection Component	Citrix App Protection Component
  Citrix HyperV Filter Driver	Citrix HyperV Filter Driver
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA
  Session Recording Agent​	Session Recording Agent​
  Elastic App Layering	​​Citrix Assistant App

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

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

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

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

• /h または /ヘルプ

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

• /追加を含める “コンポーネント”[,”コンポーネント”]

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

  マルチセッションOS	シングルセッションOS
  Citrix Backup and Restore	Citrix Backup and Restore
  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 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
  Machine Identity Service	Machine Identity Service
  	User Personalization Layer

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

• /インストールディレクトリ ディレクトリ

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

• /インストール_エムシーエスアイオー_ドライバー

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

• /ログパス パス

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

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

• /マスターイメージ

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

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

• /マスターMCSイメージ

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

• /マスターPVSイメージ

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

• /ウェブソケットトークン WebSocketトークン

  WebソケットVDAを作成します。WebSocketTokenは、必要なトークンに使用されます。

• /websockettokenfile Webソケットトークンを含むファイル

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

• /ウェブソケットトークン標準入力 <ウェブソケットトークン

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

• /ノー_メディアファンデーション_アック

  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プロトコルを参照してください。

  • プロキシアドレスの形式: 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オプションで指定されたコンポーネントを削除します。

• AppDiskの確認を削除

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

• PVDの確認を削除

  インストールされている場合、VDAインストーラーがPersonal vDiskをアンインストールすることを許可します。

• すべて削除

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

• CWAとともにすべて削除

  VDAとともにCWAを削除します。

• エクスペリエンスメトリクスを送信

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

• サーバーVDI

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

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

  このオプションは、フル製品版VDAインストーラーでのみ使用してください。

• サイトGUID 識別子

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

• /tempdir ディレクトリ

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

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

• 仮想マシン

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

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

• /ゼンデスクトップクラウド

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

VDAインストールの例

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

次のコマンドは、シングルセッションOSおよびCitrix Workspaceアプリ用のVDAを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アクセスまたはVDI展開で使用するために、シングルセッションOSにコアサービスVDAをインストールします。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コマンドで有効です。

• /イネーブル_UPSサーバー_ポート

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

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

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

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

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

• /enable_spa_ports

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

• /nosql

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

• /help または /h または /?

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

• /noreboot

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

• /クワイエット または /パッシブ

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

• /remove スイッチ

  セキュア プライベート アクセス を削除します。

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

詳細情報

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