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

はじめに

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

1. Citrixから製品パッケージをダウンロードします。ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
2. ファイルを解凍します。必要に応じて、ISOファイルをDVDに書き込みます。
3. コンポーネントをインストールするサーバーに、ローカル管理者アカウントを使用してログオンします。
4. DVDをドライブに挿入するか、ISOファイルをマウントします。
5. メディアの\x64\XenDesktop Setupディレクトリから、適切なコマンドを実行します。
   コアコンポーネントをインストールするには: XenDesktopServerSetup.exe を実行します。オプションについては、コアコンポーネントのインストール用コマンドラインオプション を参照してください。
   VDAをインストールするには: XenDesktopVDASetup.exe を実行します。オプションについては、VDAのインストール用コマンドラインオプション を参照してください。
   StoreFrontをインストールするには: インストールメディアの x64 > StoreFront フォルダーで CitrixStoreFront-x64.exe を実行します。
   Universal Print Serverをインストールするには: Universal Print Serverのインストール用コマンドラインオプション のガイダンスに従ってください。
   Federated Authentication Serviceをインストールするには: Citrixでは、グラフィカルインターフェイスを使用することをお勧めします。
   Session Recordingをインストールするには: Session Recording のガイダンスに従ってください。

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

• /components コンポーネント ...
  インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
  • CONTROLLER: コントローラー
  • DESKTOPSTUDIO: スタジオ
  • DESKTOPDIRECTOR: ディレクター
  • LICENSESERVER: Citrix ライセンスサーバー
  このオプションを省略すると、すべてのコンポーネントがインストールされます（/remove オプションも指定されている場合は削除されます）。
  （2003より前のリリースでは、有効な値には STOREFRONT が含まれていました。バージョン2003以降では、Use the full-product installer で説明されている専用のStoreFrontインストールコマンドを使用してください）。
• /configure_firewall
  Windows ファイアウォールサービスが実行されている場合、ファイアウォールが有効になっていなくても、インストールされるコンポーネントが使用するWindows ファイアウォールのすべてのポートを開きます。サードパーティのファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でポートを開く必要があります。
• /ディスエーブルエクスペリエンスメトリクス
  インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
• /help または /h
  コマンドのヘルプを表示します。
• /ignore\_hw\_check\_failure
  ハードウェアチェックが失敗した場合（たとえば、RAM不足のため）でも、Delivery Controllerのインストールまたはアップグレードを続行できるようにします。詳細については、Hardware check を参照してください。
• /ignore\_site\_test\_failure
  Controllerのアップグレード中にのみ有効です。通常、サイトテストの失敗は無視され、アップグレードは続行されます。省略された場合（またはfalseに設定された場合）、サイトテストの失敗があると、アップグレードを実行せずにインストーラーが失敗します。デフォルト = false
  アップグレード中に、サポートされていないSQL Serverバージョンが検出された場合、このオプションは無視されます。詳細については、SQL Server version check を参照してください。
• /installdir ディレクトリ
  コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
• /logpath パス
  ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト = TEMP%\Citrix\XenDesktop Installer
• /no_pending_reboot_check
  コアコンポーネントのインストールまたはアップグレード時に、マシン上の以前のWindowsインストールからの保留中の再起動のチェックを防止します。
• /no_remote_assistance
  Directorのインストール時にのみ有効です。Windowsリモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
• 再起動なし
  インストール後の再起動を防止します。（ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。）
• 再開しない
  デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。
• ノースキューエル
  ControllerをインストールしているサーバーへのMicrosoft SQL Server Expressのインストールを防止します。このオプションを省略すると、サイトデータベースとして使用するためにSQL Server Expressがインストールされます。
  このオプションは、ローカルホストキャッシュに使用されるSQL Server Express LocalDBのインストールには影響しません。
• サイレント または パッシブ
  インストール中にユーザーインターフェイスは表示されません。インストールプロセスの唯一の証拠はWindowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
• /削除
  /componentsオプションで指定されたコアコンポーネントを削除します。
• /すべて削除
  インストールされているすべてのコアコンポーネントを削除します。
• /エクスペリエンスメトリックを送信
  インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションを省略した場合（または/disableexperiencemetricsが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。
• 一時ディレクトリ directory
  インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
• ゼナップ
  Citrix Virtual Apps をインストールします。このオプションを省略すると、Citrix Virtual Apps and Desktops™ がインストールされます。

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

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

1. Citrixから適切なパッケージをダウンロードします。
   • マルチセッションOS Virtual Delivery Agent: VDAServerSetup.exe
   • シングルセッションOS Virtual Delivery Agent: VDAWorkstationSetup.exe
   • シングルセッションOS Core Services Virtual Delivery Agent: VDAWorkstationCoreSetup.exe
2. まず、パッケージから既存のディレクトリにファイルを抽出し、インストールコマンドを実行するか、単にパッケージを実行します。
   ファイルをインストールする前に抽出するには、絶対パスを指定して/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 を実行します
   ダウンロードしたパッケージを実行するには、その名前（VDAServerSetup.exe、VDAWorkstationSetup.exe、またはVDAWorkstationCoreSetup.exe）を実行します。この記事に記載されている有効なオプションを使用してください。

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

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

• /コンポーネント コンポーネント\[,コンポーネント\]
  インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
  • VDA: バーチャル デリバリー エージェント
  • PLUGINS: Citrix Workspace™ Windows 用アプリ
  VDA と Citrix Workspace app for Windows をインストールするには、/components vda,plugins を指定します。
  このオプションを省略すると、VDA のみがインストールされます（Citrix Workspace app はインストールされません）。
  このオプションは、VDAWorkstationCoreSetup_xxxx.exe インストーラーを使用する場合は無効です。そのインストーラーでは Citrix Workspace app をインストールできません。
• /controllers "コントローラー \[コントローラー\]"
  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 アダプティブトランスポートが使用する Windows ファイアウォールの UDP ポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。
  VDAが使用する追加ポートを開くには、この/enable_hdx_udp_portsオプションに加えて、/enable_hdx_portsオプションを指定します。
• /enable\_real\_time\_transport
  オーディオパケットにUDPを使用するかどうかを有効または無効にします（オーディオ用のリアルタイムオーディオトランスポート）。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。Windows ファイアウォールサービスが検出されたときにUDPポートを自動的に開く場合は、/enable_hdx_portsオプションを含めます。
• /enable_remote_assistance
  Directorで使用するために、Windowsリモートアシスタンスのシャドウイング機能を有効にします。このオプションを指定すると、Windowsリモートアシスタンスはファイアウォールで動的ポートを開きます。
• /enablerestore または /enablerestorecleanup
  （シングルセッションVDAにのみ有効）VDAのインストールまたはアップグレードが失敗した場合に、復元ポイントへの自動復帰を有効にします。
  インストール/アップグレードが正常に完了した場合：
  • /enablerestorecleanupは、インストーラーに復元ポイントを削除するよう指示します。
  • /enablerestoreは、使用されなかった場合でも、インストーラーに復元ポイントを保持するように指示します。
  詳細については、インストールまたはアップグレードの失敗時の復元を参照してください。
• /enable\_ss\_ports
  Windows ファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、画面共有に必要なポートをWindows ファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でファイアウォールを構成する必要があります。
• /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 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 Supportability Tools	Citrix Supportability Tools	Machine Management Provider
  Citrix Telemetry Service	Citrix Telemetry Service	VDA Monitor Plug-in
  Citrix Universal Print Client	Citrix Universal Print Client	VDA WMI Proxy Plug-in
  Citrix Vda Log Capture Service	Citrix Vda Log Capture Service
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  Citrix WEM Agent	Citrix WEM 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 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 "コンポーネント"\[,"コンポーネント"\]
  コンマで区切られた1つ以上のオプションコンポーネントのインストールを含めます。各コンポーネントはストレート引用符で囲まれています。このオプションは、リモートPCアクセス展開を作成していて、デフォルトで含まれていない他のコンポーネントをインストールしたい場合に役立ちます。有効な値は次のとおりです。

  マルチセッション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 Supportability Tools	Citrix Supportability Tools
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  Citrix WEM Agent	Citrix WEM Agent
  Machine Identity Service	Machine Identity Service
  	User Personalization Layer

  同じコンポーネント名で/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 をプロビジョニングするためのイメージとして使用されることを指定します。
• /no\_mediafoundation\_ack
  Microsoft Media Foundation がインストールされていないこと、およびいくつかの HDX™ マルチメディア機能がインストールされず、動作しないことを承認します。このオプションを省略し、Media Foundation がインストールされていない場合、VDA のインストールは失敗します。ほとんどのサポートされている Windows エディションには、N エディションを除き、Media Foundation がすでにインストールされています。
• デスクトップエクスペリエンスなし
  拡張デスクトップエクスペリエンス機能は利用できなくなりました。このオプション（およびポリシー設定）は、指定されても無視されます。
  マルチセッションOS用VDAをインストールする場合にのみ有効です。拡張デスクトップエクスペリエンス機能の有効化を防止します。この機能は、拡張デスクトップエクスペリエンスCitrixポリシー設定でも制御されます。
• 再起動なし
  インストール後の再起動を防止します。VDAは再起動するまで使用できません。
• 再開しない
  デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。
• ポート番号 port
  /reconfigオプションが指定されている場合にのみ有効です。VDAとController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。
• /proxyconfig “アドレスまたはPACファイルのパス”
  コマンドに/includeadditional “Citrix Rendezvous V2”が含まれている場合にのみ有効です。Rendezvousプロトコルで使用するプロキシのアドレスまたはPACファイルのパス。機能の詳細については、Rendezvous protocolを参照してください。
  • プロキシアドレスの形式: http://<url-or-ip>:<port>
  • PACファイルの形式: http://<url-or-ip>:<port>/<path>/<filename>.pac
• サイレント または パッシブ
  インストール中にユーザーインターフェイスは表示されません。インストールと構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
• /再構成
  /portnumber、/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成されたVDA設定をカスタマイズします。このオプションを/quietオプションも指定せずに指定すると、VDAをカスタマイズするためのグラフィカルインターフェイスが起動します。
• /リモートPC
  リモートPCアクセス展開（シングルセッションOS）またはブローカー接続（マルチセッションOS）の場合にのみ有効です。追加コンポーネントのインストールを除外します（/exclude および /includeadditional オプションのコンポーネントリストを参照）。
  このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。
  /remotepc は /servervdi オプションと互換性がありません。
• /削除
  /componentsオプションで指定されたコンポーネントを削除します。
• /remove_appdisk_ack
  AppDisks™ VDAプラグインがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
• /remove_pvd_ack
  Personal vDiskがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
• /すべて削除
  VDAを削除します。Citrix Workspaceアプリ（インストールされている場合）は削除しません。
• /エクスペリエンスメトリックを送信
  インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合（または/disableexperiencemetricsオプションが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。
• サーバーVDI
  サポートされているWindowsマルチセッションマシンにシングルセッションOS用VDAをインストールします。WindowsマルチセッションマシンにマルチセッションOS用VDAをインストールする場合は、このオプションを省略してください。
  このオプションを使用する前に、サーバーVDI を参照してください。
  このオプションは、フルプロダクトVDAインストーラーでのみ使用してください。
• サイトGUID guid
  サイトのActive Directory組織単位（OU）のグローバル一意識別子。これは、検出にActive Directoryを使用している場合に、仮想デスクトップをサイトに関連付けます（自動更新が推奨されるデフォルトの検出方法です）。サイトGUIDは、Studioに表示されるサイトプロパティです。/site_guidと/controllersの両方のオプションを指定しないでください。
• 一時ディレクトリ directory
  インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
  このオプションはグラフィカルインターフェイスでは利用できません。
• 仮想マシン
  VDAをVMにインストールする場合にのみ有効です。BIOS情報がVMに渡されることで物理マシンとして表示される、インストーラーによる物理マシンの検出を上書きします。
  このオプションはグラフィカルインターフェイスでは利用できません。
• /wem_add_firewall_rules
  WEMエージェントのファイアウォールルールを追加します。
• /wem_agent_cache_location
  WEMエージェントの代替キャッシュの場所。
• /wem_agent_port
  WEMエージェントがWEMインフラストラクチャサーバーと通信するために使用するポート。
• /wem_cached_data_sync_port
  WEMエージェントがWEMインフラストラクチャサーバーとキャッシュを同期するために使用するポート。
• /wem_cloud_connectors
  WEM展開を含むリソースの場所にあるCitrix Cloud™ Connectorのコンマ区切りリスト。
• /wem_server
  WEMインフラストラクチャサーバーのFQDNまたはIPアドレス。
• XenDesktopクラウド
  VDAがCitrix DaaS™ (Citrix Cloud) 展開にインストールされていることを示します。

VDAのインストール例

VDAをカスタマイズする

• /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をインストールするためのコマンドラインオプション

• /enable_upsserver_port

詳細情報