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

重要:

Personal vDisk(PvD)コンポーネントがインストールされているVDAをアップグレードする場合は、「VDAのアップグレードに関する重要な通知」を参照してください。

はじめに

この記事の対象は、WindowsオペレーティングシステムがインストールされたマシンでのVirtual Delivery Agent(VDA)のインストール、アップグレード、カスタマイズです。

この記事では、VDAのインストールコマンドの実行方法について説明します。インストールを始める前に、「VDAのインストール」を参照して、インストールに関する考慮事項、インストーラー、インストール中に指定する内容について確認してください。

コマンドラインによるVDAのインストール

VDAソフトウェアをインストールする前に、マシンがドメイン参加済みであることを確認してください。

VDAのインストールおよびコマンド実行の進行状況と戻り値の確認を行うには、管理者特権を持っているか、[管理者として実行] を使用する必要があります。

  1. VDAをインストールするマシンで、Citrix Cloudにサインインします。
  2. 左上のメニューで、[マイサービス]>[Virtual Apps and Desktops] を選択します。
  3. 右上の [ダウンロード] をクリックし、[VDAのダウンロード] を選択します。VDAのダウンロードページにリダイレクトされます。目的のVDAインストーラーを見つけて、[ファイルのダウンロード] をクリックします。
  4. ダウンロードが完了したら、ダウンロードしたファイル名を指定して実行します。この記事で説明するオプションを使用してください。

    • マルチセッションOS Virtual Delivery Agentの場合は、VDAServerSetup.exeを実行します。

    • 単一セッションOS Virtual Delivery Agentの場合は、VDAWorkstationSetup.exeを実行します。

    • 単一セッションOS Core Services Virtual Delivery Agentの場合は、VDAWorkstationCoreSetup.exeを実行します。

インストール前にファイルを展開するには、絶対パスを指定して/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を実行します。

VDAのインストールで使用するコマンドラインオプション

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

  • /components component[,component]

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

    • VDA: Virtual Delivery Agent

    • PLUGINS: Windows向けCitrix Workspaceアプリ

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

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

  • /controllerscontroller [controller]…”

    VDAが通信可能なCitrix Cloud ControllerのFQDNを、直線の二重引用符で囲んだスペース区切りのリストで指定します。/site_guid/controllersの両方を指定しないでください。

  • /disableexperiencemetrics

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

  • /enable_hdx_ports

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

    HDXアダプティブトランスポートが使用するUDPポートを解放するには、/enable_hdx_portsに加えて、/enable_hdx_udp_portsを指定します。

  • /enable_hdx_udp_ports

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

    VDAが使用するポートを解放するには、/enable_hdx_udp_portsに加えて、/enable_hdx_portsを指定します。

  • /enable_real_time_transport

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

  • /enable_remote_assistance

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

  • /excludecomponent”[,”component”]

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

    • Machine Identity Service
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrixユニバーサルプリントクライアント
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Citrix Files for Windows
    • Citrix Files for Outlook
    • ユーザー個人設定レイヤー

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

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

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

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

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

  • /hまたは/help

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

  • /hdxflashv2only

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

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

  • /includeadditional component”[,”component”] …

    インストールするオプションコンポーネントを1つ以上、それぞれ直線の二重引用符で囲みコンマ区切りで指定します。コンポーネント名の大文字と小文字は区別されます。

    このオプションを使用すると、リモートPCアクセス展開を作成する場合に、デフォルトでは含まれないコンポーネントをインストールできます。以下の値を指定します。

    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrixユニバーサルプリントクライアント
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Citrix Files for Windows
    • Citrix Files for Outlook
    • ユーザー個人設定レイヤー

    /excludeおよび/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で使用するマスターイメージに指定します。このオプションでは、TargetOSOptimizer.exeもインストールされます(オプティマイザーのインストーラーが含まれるexclude "Machine Identity Service"を指定しない場合のみ)。このオプションは/masterimageと同等です。

  • /masterpvsimage

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

  • /no_mediafoundation_ack

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

  • /nodesktopexperience

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

  • /noreboot

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

  • /noresume

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

  • /optimize

    MCSを使用し、この機能を有効にする場合(デフォルト), 仮想マシンの最適化によってオフラインファイルが無効になり、バックグラウンド最適化(デフラグ処理)が無効になり、イベントログのサイズが縮小されます。詳しくは、「CTX125874」を参照してください。

    最適化するには、この機能を有効にするだけでなく、Machine Identity Serviceをインストールする必要もあります。このサービスにはTargetOSOptimizer.exeが含まれています。/mastermcsimageまたは/masterimageを指定し、/exclude "Machine Identity Service"を指定しないと、Machine Identity Serviceが自動的にインストールされます。

  • /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)でのみ有効です。次のコンポーネントのインストールを除外します:

    • Citrix Personalization for App-V
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Machine Identity Service
    • Citrix Supportability Tools
    • Citrix Files for Windows
    • Citrix Files for Outlook
    • ユーザー個人設定レイヤー

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

  • /remove

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

  • /removeall

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

  • /sendexperiencemetrics

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

  • /servervdi

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

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

  • /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のインストール

次のコマンドでは、マルチセッションOSにVDAをインストールします。マスターイメージにはVDAを使用します。

VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimge

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

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

コマンドラインを使ったVDAのカスタマイズ

VDAをインストールした後で、いくつかの設定をカスタマイズできます。次のオプションの1つまたは複数を使用して、XenDesktopVDASetup.exeを実行します。

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

次のステップ

マシンカタログの作成

構成プロセスの全体像については、「インストールと構成」を参照してください。