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

最終公開日 : Nov 13, 2026
重要:
  • アップグレードする場合で、現在のバージョンで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 をインストールするには: Citrix ではグラフィカルインターフェイスの使用を推奨しています。
    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 など.
    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 Customer Experience Improvement Program」を参照してください。
    CEIP データの詳細については、「Citrix Licensing CEIP data elements」を参照してください。
    ライセンスサーバーのライセンスデータの詳細については、「Citrix Licensing Data」を参照してください。
  • /components コンポーネント ...
    インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
    • CONTROLLER: コントローラー
    • DESKTOPSTUDIO: スタジオ
    • WEBSTUDIO: Web スタジオ
    • 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製品コンポーネントはインストールされません。
  • /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_remote_assistance
    Directorのインストール時にのみ有効です。Windowsリモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
  • 再起動なし
    インストール後の再起動を防止します。(ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。)
  • 再開しない
    デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。
  • /SQLなし
    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™ がインストールされます。

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

次のコマンドは、サーバーに 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
    ライセンスバイナリをローカルドライブのいずれかにコピーした場合は、次のコマンドを実行します。
    \x64\Licensing\CitrixLicensing.exe /quiet /l install.log
  2. 次を実行します。
    \x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL

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

ダウンロードサイトにアクセスするには、Citrix アカウントの資格情報が必要です。インストールを開始する前に、管理者権限を昇格させるか、 を使用する必要があります。
  1. Citrix から適切なパッケージをダウンロードします。
    • マルチセッションOS Virtual Delivery Agent: VDAServerSetup_xxxx.exe
    • シングルセッションOS Virtual Delivery Agent: 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: Citrix Secure Access™ クライアント
  • PLUGINS: Windows 用 Citrix Workspace™ アプリ
  • UPL: Citrix ユーザーパーソナライゼーションレイヤー
VDAとCitrix Workspaceアプリ for Windowsをインストールするには、/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 のインストール」を参照してください。
  • /コンポーネント コンポーネント\[,コンポーネント\]
    インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
    • VDA: バーチャル デリバリー エージェント
    • PLUGINS: Windows 用 Citrix Workspace アプリ
    • CSA: Citrix セキュア アクセス クライアント
    • UPL: Citrix ユーザー パーソナライゼーション レイヤー
VDA と Windows 用 Citrix Workspace アプリをインストールするには、/components vda, plugins, CSA, UPL を指定するか、コンポーネントをまったく指定しないでください。コンポーネントが指定されていない場合、デフォルトでは VDA のみがインストールされます。
VDA のみをインストールし、Citrix Workspace アプリのインストールを除外するには、/components vda を指定します。
このオプションは、VDAWorkstationCoreSetup_xxxx.exe インストーラーを使用する場合には無効です。そのインストーラーは、Citrix Workspace アプリをインストールできません。
  • /オンリープレレックス
    選択したコンポーネントの前提条件のみがインストールされます。Citrix 製品コンポーネントはインストールされません。
  • /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_hdx_tls_dtls
    HDX™ Direct V1用にTCPおよびUDPポート443を開きます。
  • /enable\_real\_time\_transport
    オーディオパケットにUDPを使用する機能(RealTime Audio Transport for audio)を有効または無効にします。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。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
    HDX™ドライバーのVDAメタインストーラーへのチェックをスキップします。
  • /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
    インストールから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
    コマンドのヘルプを表示します。
  • /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 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 ディレクトリ
    コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = 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をプロビジョニングするためのイメージとして使用されることを指定します。
  • /websockettoken WebSocketトークン
    Web Socket VDAを作成します。WebSocketTokenは、必要なトークン用です。
  • /websockettokenfile WebSockトークンを含むファイル
    Web Socket VDAを作成します。FileContainingWebSockToken は、必要なトークンを含むファイル用です。
  • ウェブソケットトークン標準入力 <ウェブソケットトークン>
    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レジストリキーをチェックして、値が存在し、空でないことを確認してください。
  • デスクトップエクスペリエンスなし
    拡張デスクトップエクスペリエンス機能は利用できなくなりました。このオプション(およびポリシー設定)は、指定されても無視されます。
    マルチセッションOS用のVDAをインストールする場合にのみ有効です。拡張デスクトップエクスペリエンス機能の有効化を防止します。この機能は、拡張デスクトップエクスペリエンスCitrixポリシー設定でも制御されます。
  • 再起動なし
    インストール後の再起動を防止します。VDAは再起動するまで使用できません。
  • 再開しない
    デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。
  • フィジカルマシン
    RemotePCインストールでは、/remotepcとともにこの引数を使用してください。そうしないと、特定のユーザーシナリオでVDAが期待どおりに動作しない可能性があります。
  • ポート番号 port
    /reconfigオプションが指定されている場合にのみ有効です。VDAとController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。
  • /proxyconfig “アドレスまたはPACファイルパス”
    環境内でGateway ServiceなどのサービスとともにRendezvous V2プロトコルを使用する予定があり、アウトバウンド接続のためにネットワークに非透過プロキシがある場合は、ここでプロキシを指定します。HTTPプロキシのみがサポートされています。Rendezvousプロトコルで使用するプロキシのアドレスまたはPACファイルパス。このコマンドラインは、/includeadditional "Citrix Rendezvous V2"が使用されたかのように、Citrix Rendezvous V2を自動的にインストールします。機能の詳細については、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
    Remote PC Access展開(シングルセッションOS)またはブローカー接続(マルチセッションOS)の場合にのみ有効です。追加コンポーネントのインストールを除外します(/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。
    このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。
    /remotepcは/servervdiオプションと互換性がありません。
  • /削除
    /componentsオプションで指定されたコンポーネントを削除します。
  • /remove_appdisk_ack
    AppDisks™ VDAプラグインがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
  • /remove_pvd_ack
    Personal vDiskがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
  • /すべて削除
    VDAを削除します。Citrix Workspaceアプリ(インストールされている場合)は削除しません。
  • /REMOVEALLWITHCWA
    VDAとともにCWAを削除します。
  • /エクスペリエンスメトリックを送信
    インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合(または/disableexperiencemetricsオプションが指定された場合)、分析データはローカルで収集されますが、自動的には送信されません。
  • サーバーVDI
    サポートされているWindowsマルチセッションマシンにシングルセッションOS用VDAをインストールします。WindowsマルチセッションマシンにマルチセッションOS用VDAをインストールする場合は、このオプションを省略してください。
    このオプションを使用する前に、Server VDIを参照してください。
    このオプションは、フルプロダクトVDAインストーラーでのみ使用してください。
  • サイトGUID guid
    サイトのActive Directory組織単位(OU)のグローバル一意識別子。これは、検出にActive Directoryを使用している場合に、仮想デスクトップをサイトに関連付けます(自動更新が推奨されるデフォルトの検出方法です)。サイトGUIDは、Studioに表示されるサイトプロパティです。/site_guidと/controllersの両方のオプションを指定しないでください。
  • 一時ディレクトリ directory
    インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
    このオプションはグラフィカルインターフェイスでは利用できません。
  • 仮想マシン
    VDAをVMにインストールする場合にのみ有効です。BIOS情報がVMに渡されることで物理マシンとして表示される、インストーラーによる物理マシンの検出を上書きします。
    このオプションはグラフィカルインターフェイスでは利用できません。
  • XenDesktopクラウド
    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のインストール:
次のコマンドは、リモート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 または /h または /?
    コマンドヘルプを表示します
  • 再起動なし
    インストール後の再起動を防止します。Secure Private Access は、再起動するまで使用できません。
  • /quiet または /passive
    インストール中にユーザーインターフェイスは表示されません。インストールと構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
  • /削除
    Secure Private Access を削除します。
オプションの詳細については、Secure Private Access インストーラーを参照してください。

詳細情報

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