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

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

重要:

このアーティクルでは、製品のインストールコマンドの実行方法を説明します。インストールを始める前に、「インストールの準備」を読んでください。そのアーティクルには、利用できるインストーラーの説明があります。

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

インストールコマンドを直接使用するだけでなく、製品ISOにあるサンプルスクリプトを使用して、Active DirectoryでVDAマシンをインストール、アップグレード、または削除できます。詳しくは、「スクリプトを使用したVDAのインストール」を参照してください。

この製品バージョンでサポートされていないOSにWindows VDAをインストール(またはアップグレード)しようとすると、メッセージが表示され、オプションについて記述された情報が示されます。この情報は、「以前のオペレーティングシステム」にも記載されています。

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

全製品インストーラーの使用

全製品インストーラーのコマンドラインインターフェイスへのアクセス:

  1. Citrixから製品パッケージをダウンロードします。ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
  2. ファイルを解凍します。必要な場合は、ISOファイルからDVDを作成します。
  3. ローカルの管理者アカウントを使って、インストール先のサーバーにログオンします。
  4. DVDをドライブに挿入するか、ISOファイルをマウントします。
  5. 製品メディアの\x64\XenDesktop Setupディレクトリから適切なコマンドを実行します。

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

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

Universal Print Serverをインストールするには:コマンドラインを使ったUniversal Print Serverのインストール」のガイダンスに従ってください。

Federated Authentication Serviceをインストールするには: グラフィカルインターフェイスを使用することをお勧めします

セルフサービスパスワードリセットサービスをインストールするには: セルフサービスパスワードリセットサービスのガイダンスに従ってください。

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

スタンドアロンVDAインストーラーの使用

ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。インストールは、管理者権限(または [管理者として実行])で実行する必要があります。

  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)。ディレクトリはあらかじめ存在する必要があります。存在しない場合、抽出に失敗します。
      • 次に、新しいコマンドプロンプトを開いて、抽出先フォルダー(上の例ではCitrixVDAInstallMedia)からXenDesktopVdaSetup.exeを実行します。「VDAのインストールに使用されるコマンドラインオプション」セクションの有効なオプションを使用してください。
    • ダウンロードしたパッケージを実行する場合は、次の名前のファイルを実行するだけです。 VDAServerSetup.exe、VDAWorkstationSetup.exe、またはVDAWorkstationCoreSetup.exe。「VDAのインストールに使用されるコマンドラインオプション」セクションの有効なオプションを使用してください。

全製品インストーラーに慣れている場合:

  • スタンドアロンのVDAServerSetup.exeまたはVDAWorkstationSetup.exeは名前以外、XenDesktopVdaSetup.exeコマンドと同じですので、同様に実行してください。

  • VDAWorkstationCoreSetup.exeインストーラーは、他のインストーラーで利用できるオプションのサブセットをサポートしているので異なります。

コアコンポーネントのインストールに使用されるコマンドラインオプション

次のオプションは、XenDesktopServerSetup.exeコマンドを使用してコアコンポーネントをインストールするときに有効です。オプションについて詳しくは、「コアコンポーネントのインストール」を参照してください。

  • /components component [,component] …

    インストールまたは削除するコンポーネントをコンマ区切りのリストで指定します。以下の値を指定します。

    • CONTROLLER:Controller
    • DESKTOPSTUDIO:Studio
    • DESKTOPDIRECTOR:Director
    • LICENSESERVER:Citrixライセンスサーバー
    • STOREFRONT:StoreFront

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

  • /configure_firewall

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

  • /disableexperiencemetrics

    Citrix Insight Servicesへのインストール、アップグレード、または削除中に収集される分析の自動アップロードが阻止されます。

  • /exclude

    二重引用符で囲まれた機能、サービス、またはテクノロジをインストールしません。複数の機能、サービス、またはテクノロジを指定する場合は、コンマで区切って、それぞれを二重引用符で囲みます。以下の値を指定します。

    • “Local Host Cache Storage (LocalDB)”:ローカルホストキャッシュに使用されるデータベースのインストールが阻止されます。このオプションは、サイトデータベースとして使うためにSQL Server Expressがインストールされているかどうかには影響しません。

    • “Smart Tools Agent”:Citrix Smart Toolsエージェントのインストールが阻止されます。

  • /helpまたは/h

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

  • /ignore_site_test_failure

    Controllerのアップグレード中にのみ有効です。サイトテストの失敗は無視され、アップグレードが進行します。省略された場合(またはfalseに設定されている場合)、サイトテストに失敗するとアップグレードを実行せずにインストーラーが失敗します。デフォルト値:false

  • /installdir directory

    コンポーネントのインストール先として既存の空ディレクトリを指定します。デフォルト値:c:\Program Files\Citrix

  • /logpath path

    ログファイルのパスを指定します。既存のフォルダーを指定する必要があります。インストーラーによって作成されません。Default = 「%TEMP%\Citrix\XenDesktop Installer」

  • /no_remote_assistance

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

  • /noreboot

    インストール後の再起動を無効にします(ほとんどのコアコンポーネントでは、デフォルトで再起動が無効になっています)。

  • /nosql

    Controllerのインストール先サーバーにMicrosoft SQL Server Expressをインストールしない場合に指定します。このオプションを指定しない場合、SQL Server Expressがサイトデータベースとして使用するためにインストールされます。(このオプションは、ローカルホストキャッシュに使用されるSQL Server Express LocalDBのインストールには影響しません)。

  • /quietまたは/passive

    ユーザーインターフェイスを表示せずにインストールを実行します。インストールプロセスは、Windowsタスクマネージャーにのみ表示されます。このオプションを指定しない場合、インストールウィザードが表示されます。

  • /remove

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

  • /removeall

    インストール済みのすべてのコアコンポーネントを削除します。

  • /sendexperiencemetrics

    Citrix Insight Servicesへのインストール、アップグレード、または削除中に収集される分析が自動的に送信されます。これが省略される場合(または/disableexperiencemetricsが指定される場合)、分析はローカルで収集されますが、自動的には送信されません。

  • /tempdir directory

    インストール時に一時ファイルを作成するディレクトリを指定します。デフォルト値:c:\Windows\Temp

  • /xenapp

    Citrix Virtual Appsをインストールします。このオプションを指定しない場合、Citrix Virtual Apps and Desktopsがインストールされます。

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

次のコマンドを実行すると、Citrix Virtual Apps and Desktops、Controller、Studio、Citrixライセンスサーバー、および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

VDAのインストールに使用されるコマンドラインオプション

次のオプションは、次の各コマンドの1つ以上で使用できます:XenDesktopVDASetup.exeVDAServerSetup.exeVDAWorkstationSetup.exeVDAWorkstationCoreSetup.exe

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

  • /baseimage

    仮想マシン上にVDA for Desktop OSをインストールする場合にのみ有効です。マスターイメージでのPersonal vDiskの使用を有効にします。Personal vDiskは廃止されました。

    このオプションはVDAWorkstationCoreSetup.exeインストーラーの使用時には無効です。

  • /components component[,component]

    インストールまたは削除するコンポーネントをコンマ区切りのリストで指定します。以下の値を指定します。

    • VDA: Virtual Delivery Agent
    • PLUGINS: Windows向けCitrix Workspaceアプリ

    VDAおよびWindows向けCitrix Workspaceアプリをインストールするには、「/components vda, plugins」と指定します。

    このオプションを指定しない場合、VDAのみがインストールされます(Citrix Workspaceアプリはインストールされません)。

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

  • /controllers “controller [controller]“

    VDAが通信するControllerのFQDNを、引用符で囲んだスペース区切りのリストで指定します。/site_guidと/controllersを一緒に指定しないでください。

  • /disableexperiencemetrics

    Citrix Insight Servicesへのインストール、アップグレード、または削除中に収集される分析の自動アップロードが阻止されます。

  • /enable_framehawk_port

    Framehawkで使用されるUDPポートを開放します。デフォルト値:false

  • /enable_hdx_ports

    Windowsファイアウォールサービスが実行されている場合に(ファイアウォールが無効になっていても)、Controllerおよび有効な機能(Windowsリモートアシスタンスは除く)で必要なポートが開放されます。Windows以外のファイアウォールを使用している場合は、手作業でファイアウォールを構成する必要があります。ポートの詳細については、「ネットワークポート」を参照してください。

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

  • /enable_hdx_udp_ports

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

    VDAとControllerおよび有効化された機能との通信に使用するUDPポートを新たに解放するには、このオプションに加えて、/enable_hdx_portsオプションを指定します。

  • /enable_real_time_transport

    オーディオパケットでUDPを使用してパフォーマンスを向上させる機能(リアルタイムオーディオ転送)を有効または無効にします。この機能を有効にすると、オーディオパフォーマンスを向上させることができます。Windowsファイアウォールサービスが検出されたときにUDPポートが開放されるようにするには、/enable_hdx_portsを指定してください。

  • /enable_remote_assistance

    Directorで使用するWindowsリモートアシスタンスのシャドウ機能を有効にします。このオプションを指定すると、Windowsリモートアシスタンスによってファイアウォールで動的ポートが解放されます。

  • /exclude “component”[,”component”]

    二重引用符で囲まれた、オプションコンポーネントをインストールしません。複数のコンポーネントを指定する場合は、コンマで区切って、それぞれを二重引用符で囲みます。たとえば、MCSが管理していないイメージ上でVDAをインストールまたはアップグレードする場合、Machine Identity Serviceコンポーネントは必要ありません。以下の値を指定します。

    • AppDisks VDAプラグイン
    • Personal vDisk
    • Machine Identity Service
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrix Universal Print Client
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Smart Tools Agent
    • Citrix Files for Windows

    インストールからCitrix Profile Managementを除くと(/exclude “Citrix User Profile Manager”オプションを使用)、Citrix Directorを使ったVDAの監視やトラブルシューティングに影響があります。[ユーザーの詳細]ページの[個人設定]パネル、および[EndPoint]ページの[ログオン処理時間]パネルに不具合が発生します。[ダッシュボード]ページと[傾向]ページでは、Profile managementがインストールされているマシンについてのデータしか[平均ログオン処理時間]パネルに表示されません。

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

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

    /includeおよび/includeadditionalの両方に同じ追加コンポーネント名を指定した場合、そのコンポーネントはインストールされません。

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

  • /hまたは/help

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

  • /hdxflashv2only

    セキュリティを強化するため、従来のFlashリダイレクトのバイナリをインストールしません。

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

  • /includeadditional

    インストールするオプションコンポーネントを1つ以上、それぞれ二重引用符で囲みコンマ区切りで指定します。このオプションを使用すると、リモートPCアクセス展開を作成する場合に、デフォルトでは含まれない追加コンポーネントをインストールできます。以下の値を指定します。

    • Personal vDisk
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrix Universal Print Client
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Smart Tools Agent
    • Citrix Files for Windows

    /includeおよび/includeadditionalの両方に同じ追加コンポーネント名を指定した場合、そのコンポーネントはインストールされません。

  • /installdir directory

    コンポーネントのインストール先として既存の空ディレクトリを指定します。デフォルト値:c:\Program Files\Citrix

  • /install_mcsio_driver

    ストレージの最適化のため、MCS I/O書き込みキャッシュを有効にします。

  • /logpath path

    ログファイルのパスを指定します。既存のフォルダーを指定する必要があります。インストーラーによって作成されません。Default = 「%TEMP%\Citrix\XenDesktop Installer」

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

  • /masterimage

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

    このオプションはVDAWorkstationCoreSetup.exeインストーラーの使用時には無効です。

  • /mastermcsimage

    インストールするマシンを、Machine Creation ServicesでVMのプロビジョニングに使用するマスターイメージに指定します。このオプションは/masterimageと同等です。

  • /masterpvsimage

    インストールするマシンを、Citrix Provisioningまたはサードパーティのプロビジョニングツール(Microsoft System Center Configuration Managerなど)でVMのプロビジョニングに使用するマスターイメージに指定します。

  • /no_mediafoundation_ack

    MicrosoftのMedia Foundationがインストールされていなければ、複数のHDXマルチメディア機能はインストールされず、動作しないものがあることを認識します。このオプションが省略されていて、Media Foundationがインストールされていない場合、VDAインストールは失敗します。サポートされているほとんどのWindowsのエディションには、Nエディションの例外を除けば、Media Foundationが既にインストールされています。

  • /nodesktopexperience

    VDA for Server OSをインストールする場合にのみ有効です。デスクトップエクスペリエンス拡張機能を無効にします。この機能の有効/無効は、Citrixポリシーの[デスクトップエクスペリエンス拡張]設定でも制御できます。

  • /noreboot

    インストール後の再起動を無効にします。VDAは、再起動後にのみ使用できます。

  • /noresume

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

  • /optimize

    仮想マシン上にVDAをインストールする場合にのみ有効です。ハイパーバイザー上の仮想マシンにインストールするVDAを最適化します。仮想マシンの最適化には、オフラインファイルの無効化、バックグラウンド最適化(デフラグ処理)の無効化、およびイベントログサイズの縮小などの操作が含まれます。リモートPCアクセスの展開では、このオプションを指定しないでください。詳しくは、CTX125874を参照してください。

  • /portnumber port

    /reconfigオプションを指定する場合にのみ有効です。Virtual Delivery AgentとController間の通信で使用されるポート番号を変更します。変更前のポートは無効になります(ポート80を除く)。

  • /quiet または /passive

    ユーザーインターフェイスを表示せずにインストールを実行します。インストールおよび構成プロセスは、Windowsタスクマネージャーにのみ表示されます。このオプションを指定しない場合、インストールウィザードが表示されます。

  • /reconfigure

    インストール済みのVirtual Delivery Agent設定をカスタマイズします。/portnumber、/controllers、または/enable_hdx_portsオプションと一緒に使用します。/quietオプションを指定しない場合は、VDAをカスタマイズするためのグラフィカルインターフェイスが開きます。

  • /remotepc

    リモートPCアクセス展開(デスクトップOS)または仲介接続(サーバーOS)でのみ有効です。デスクトップOSで次のコンポーネントのインストールを除外します。

    • Citrix Personalization for App-V
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Machine Identity Service
    • Personal vDisk
    • Citrix Supportability Tools
    • Citrix Files for Windows

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

  • /remove

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

  • /removeall

    インストール済みのすべてのコンポーネントを削除します。

  • /sendexperiencemetrics

    Citrix Insight Servicesへのインストール、アップグレード、または削除中に収集される分析が自動的に送信されます。これが省略される場合(または/disableexperiencemetricsが指定される場合)、分析はローカルで収集されますが、自動的には送信されません。

  • /servervdi

    Windowsサーバー上にVDA for Desktop OSをインストールします。Windowsサーバー上にVDA for Server OSをインストールする場合は、このオプションを指定しないでください。このオプションを使用する前に、「サーバーVDI」を参照してください。

    このオプションは、全製品VDAインストーラーでのみ使用してください。このオプションはグラフィックインターフェイスでは使用できません。

  • /site_guid guid

    サイトのActive Directory組織単位(OU)のグローバル一意識別子(GUID)を指定します。Active Directory OUベースのController検出を使用する場合、GUIDにより仮想デスクトップとサイトが関連付けられます(デフォルトの検出方法である自動更新を使用することをお勧めします)。サイトGUIDは、Studioに表示されるサイトプロパティです。/site_guidと/controllersを一緒に指定しないでください。

  • /tempdir directory

    インストール時に一時ファイルを作成するディレクトリを指定しますデフォルト値:c:\Windows\Temp

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

  • /virtualmachine

    仮想マシン上にVDAをインストールする場合にのみ有効です。インストーラーによる物理マシンの検出を上書きして、BIOS情報を仮想マシンに渡して物理マシンとして振る舞うようにします。

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

VDAのインストールの例

フル製品インストーラーを使用してVDAをインストールします:

次のコマンドを実行すると、仮想マシン上のデフォルトの場所にVDA for Desktop OSおよびCitrix Workspaceアプリがインストールされます。この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 /optimize /mastermcsimage /enable\_remote\_assistance

VDAWorkstationCoreSetupスタンドアロンインストーラーでデスクトップOS VDAをインストールする:

次のコマンドは、リモートPCアクセスまたはVDI展開で使用するためにデスクトップOSにCore Services VDAをインストールします。Citrix Workspaceアプリとその他の非コアサービスはインストールされません。Controllerのアドレスが指定され、Windowsファイアウォールサービスのポートが自動的に開放されます。管理者が再起動を処理します。

VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable\_hdx\_ports /noreboot

VDAのカスタマイズ

VDAをインストールした後で、いくつかの設定をカスタマイズできます。製品メディアの\x64\XenDesktop Setupフォルダーから、以下のオプションを指定してXenDesktopVdaSetup.exeを実行します(各オプションについては「VDAのインストールに使用されるコマンドラインオプション」を参照してください)。

  • /reconfigure(VDAをカスタマイズする場合は必須のオプションです)
  • /h または /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber <port>
  • /enable_hdx_ports

Universal Print Serverのインストール

この手順を使用して、プリントサーバーにUniversal Print Server UpsServerコンポーネントをインストールします。

Citrixインストールメディアの\x64\Universal Print Server\ディレクトリから、UpsServer_x64.msiを実行します。インストールメディアがない場合は、このダウンロードページに移動し、[ファイルをダウンロード] をクリックします。

プリントサーバーにUniversal Print Serverコンポーネントをインストールした後で、「プリンターのプロビジョニング」の説明に従って、このコンポーネントを構成します。