Citrix Virtual Apps and Desktops

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

重要:

  • アップグレードを行う場合で、現在のバージョンがPersonal vDiskまたはAppDisksソフトウェアを使用しているか、インストールされている場合は、「PvD、AppDisks、およびサポートされていないホストの削除」を参照してください。

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

はじめに

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

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

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

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

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

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

フルプロダクトインストーラーの使用

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

  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をインストールするためのコマンドラインオプション」のガイダンスに従ってください。

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

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

    Workspace Environment Managementをインストールするには:Workspace Environment Management」のガイダンスに従ってください。

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

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

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

注:

  • コアコンポーネントをインストールするためのコマンドラインオプションを使用している間は、/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」を参照してください。

    CEIPデータの収集について詳しくは、「Citrix Licensingカスタマーエクスペリエンス向上プログラム」を参照してください。

    CEIPデータの詳細については、「Citrix Licensing CEIPデータ要素」を参照してください。

    License Serverライセンスデータの詳細については、「Citrixライセンスデータ」を参照してください。

  • /components component [,component] …

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

    • CONTROLLER:Controller
    • DESKTOPSTUDIO:Studio
    • WEBSTUDIO:Web Studio
    • DESKTOPDIRECTOR:Director
    • LICENSESERVER:Citrix License Server
    • 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がサイトデータベースとして使用するためにインストールされます。

    このオプションは、Local Host Cacheに使用される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™ がインストールされます。

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

次のコマンドは、Delivery Controller™、Studio、Citrix Licensing、およびSQL Server Expressをサーバーにインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
<!--NeedCopy-->

次のコマンドは、Citrix Virtual Apps™ Controller、Studio、およびSQL Server Expressをサーバーにインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
<!--NeedCopy-->

次のコマンドは、Delivery Controller、Secure Private Access、およびSQL Server Expressをサーバーにインストールします。コンポーネント間の通信に必要なファイアウォールポートは自動的に開かれます。

\x64\XenDesktop Setup
XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall
<!--NeedCopy-->

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-->
    

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

    \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 Virtual Delivery Agent:VDAServerSetup_xxxx.exe
    • シングルセッションOS Virtual Delivery Agent:VDAWorkstationSetup_xxxx.exe
    • シングルセッションOS Core Services Virtual Delivery Agent: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.exeVDAWorkstationSetup.exe、またはVDAWorkstationCoreSetup.exe)を実行します。この記事に記載されている有効なオプションを使用してください。

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

  • スタンドアロンのVDAServerSetup.exeまたはVDAWorkstationSetup.exeインストーラーを、名前以外のすべてにおいてXenDesktopVdaSetup.exeコマンドであるかのように実行します。

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

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

  • VDA: Virtual Delivery Agent
  • CSA: Citrix Secure Access™ Client
  • PLUGINS: Windows向けCitrix Workspace™アプリ
  • UPL: Citrix User Personalization Layer(WS VDAのみ)
  • SRAGENT: Session Recording Agent
  • ASSISTANTAPP: Citrix Assistant App(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)Agentは、デフォルトのVDAインストールに統合されています。これらのコンポーネントは、VDAセットアップの一部としてサイレントインストールされ、個別のコンポーネントとして管理されなくなりました。

注:

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

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

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

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

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

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

  • /components component[,component]

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

    • VDA: Virtual Delivery Agent
    • PLUGINS: Windows向けCitrix Workspaceアプリ
    • CSA: Citrix Secure Access Client
    • UPL: Citrix User Personalization Layer(WS VDAのみ)
    • SRAGENT: Session Recording Agent
    • ASSISTANTAPP: Citrix Assistant App(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製品コンポーネントはインストールされません。

  • /controllerscontroller [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アダプティブトランスポートが使用するUDPポートをWindowsファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。

    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™ドライバーのチェックをスキップします。

  • /excludecomponent”[,”component”]

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

    マルチセッションOS シングルセッションOS シングルセッションOS Core Services
    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 または /help

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

  • /includeadditionalcomponent”[,”component”]

    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 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の両方を同じコンポーネント名で指定した場合、そのコンポーネントはインストールされません。

  • /installdir directory

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

  • /install_mcsio_driver

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

  • /logpath path

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

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

  • /masterimage

    VDAをVMにインストールする場合にのみ有効です。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とController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。

  • /proxyconfigaddress 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
  • /quiet or /passive

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

  • /reconfigure

    /portnumber/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成されたVDA設定をカスタマイズします。このオプションを/quietオプションも指定せずに指定すると、VDAをカスタマイズするためのグラフィカルインターフェイスが起動します。

  • /remotepc

    Remote PCアクセス展開(シングルセッションOS)またはブローカー接続(マルチセッションOS)の場合にのみ有効です。追加コンポーネントのインストールを除外します(/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。

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

    /remotepc/servervdiオプションと互換性がありません。

  • /remove

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

  • /remove_appdisk_ack

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

  • /remove_pvd_ack

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

  • /removeall

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

  • /REMOVEALLWITHCWA

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

  • /sendexperiencemetrics

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

  • /servervdi

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

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

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

  • /site_guid guid

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

  • /tempdir directory

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

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

  • /virtualmachine

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

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

  • /xendesktopcloud

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

VDAインストールの例

フル製品インストーラーを使用したVDAのインストール:

次のコマンドは、シングルセッションOS用VDAとCitrix Workspaceアプリを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コマンドで有効です。

  • /enable_upsserver_port

このオプションが指定されていない場合、インストーラーはグラフィカルインターフェイスからファイアウォールページを表示します。インストーラーに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 or /h or /?

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

  • /noreboot

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

  • /quiet or /passive

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

  • /remove

    Secure Private Accessを削除します。

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

詳細情報

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