コマンドラインを使用してインストールする
この記事は、Windowsオペレーティングシステムを搭載したマシンへのコンポーネントのインストールに適用されます。Linuxオペレーティングシステム用VDAについては、Linux Virtual Delivery Agentのドキュメントを参照してください。
重要：
この記事では、製品のインストールコマンドを発行する方法について説明します。インストールを開始する前に、インストールの準備を確認してください。その記事には、利用可能なインストーラーの説明が含まれています。
コマンド実行の進行状況と戻り値を確認するには、元の管理者であるか、管理者として実行を使用する必要があります。詳細については、Microsoftのコマンドドキュメントを参照してください。
インストールコマンドを直接使用することに加えて、Active Directory内のVDAマシンをインストール、アップグレード、または削除するサンプルスクリプトが製品ISOに用意されています。詳細については、スクリプトを使用したVDAのインストールを参照してください。
フルプロダクトインストーラーを使用する
フルプロダクトインストーラーのコマンドラインインターフェイスにアクセスするには：
- Citrixから製品パッケージをダウンロードします。ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
- ファイルを解凍します。必要に応じて、ISOファイルをDVDに書き込みます。
- コンポーネントをインストールするサーバーに、ローカル管理者アカウントを使用してログオンします。
- DVDをドライブに挿入するか、ISOファイルをマウントします。
- メディア上の
\x64\XenDesktop Setupディレクトリから、適切なコマンドを実行します。
コアコンポーネントをインストールするには
コアコンポーネントをインストールするためのコマンドラインオプションに記載されているオプションを指定して、XenDesktopServerSetup.exeコマンドを実行します。
VDAをインストールするには
VDAインストール用のコマンドラインオプションに記載されているオプションを指定して、XenDesktopVDASetup.exeコマンドを実行します。
ユニバーサルプリントサーバーをインストールするには
コマンドラインを使用したUniversal Print Serverのインストールのガイダンスに従ってください。
フェデレーション認証サービスをインストールするには
Citrixでは、グラフィカルインターフェイスの使用を推奨しています。
セルフサービスパスワードリセットサービスをインストールするには
セルフサービスパスワードリセットサービスのドキュメントのガイダンスに従ってください。
スタンドアロンVDAインストーラーを使用する
ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。インストールを開始する前に、管理者権限を昇格させるか、管理者として実行を使用する必要があります。
- Citrixから適切なパッケージをダウンロードします。
| ダウンロードページのコンポーネント名 | インストーラーファイル名 |
|---|---|
| サーバーOS 仮想配信エージェント <version> | VDAServerSetup.exe |
| デスクトップOS バーチャル デリバリー エージェント <version> | VDAWorkstationSetup.exe |
| デスクトップOS コアサービス バーチャル デリバリー エージェント <version> | VDAWorkstationCoreSetup.exe |
- まずパッケージから既存のディレクトリにファイルを抽出し、インストールコマンドを実行するか、パッケージをそのまま実行します。
ファイルをインストールする前に抽出するには、絶対パスを指定して/extractを使用します（例: .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia）。（ディレクトリが存在している必要があります。存在しない場合、抽出は失敗します。）その後、別のコマンドで、抽出されたコンテンツを含むディレクトリからXenDesktopVdaSetup.exeを実行します（上記の例ではCitrixVDAInstallMedia）。有効なオプションについては、「VDAのインストール用コマンドラインオプション」を参照してください。
ダウンロードしたパッケージを実行するには、その名前（VDAServerSetup.exe、VDAWorkstationSetup.exe、またはVDAWorkstationCoreSetup.exe）を実行するだけです。有効なオプションについては、「VDAのインストール用コマンドラインオプション」を参照してください。
フル製品インストーラーに慣れている場合：
-
スタンドアロンの
VDAServerSetup.exeまたはVDAWorkstationSetup.exeインストーラーを、その名前を除いてXenDesktopVdaSetup.exeコマンドであるかのように実行します。 -
VDAWorkstationCoreSetup.exeインストーラーは、他のインストーラーで利用可能なオプションのサブセットをサポートしているため、異なります。
コアコンポーネントをインストールするためのコマンドラインオプション
以下のオプションは、XenDesktopServerSetup.exeコマンドでコアコンポーネントをインストールする際に有効です。オプションの詳細については、「コアコンポーネントのインストール」を参照してください。
/components <component> [,<component>] …
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
CONTROLLER: コントローラー
DESKTOPSTUDIO: スタジオ
DESKTOPDIRECTOR: ディレクター
LICENSESERVER: Citrix ライセンスサーバー
このオプションを省略すると、すべてのコンポーネントがインストールされます (/remove オプションも指定されている場合は、削除されます)。
(7.15 LTSR CU6より前のリリースでは、有効な値にStoreFrontが含まれていました。バージョン7.15 LTSR CU6以降では、StoreFrontのインストールに記載されている専用のStoreFrontインストールコマンドを使用してください)。
/コンフィギュア_ファイアウォール
インストールされているコンポーネントによって使用されるWindowsファイアウォールのすべてのポートを開きます。Windowsファイアウォールサービスが実行されている場合、ファイアウォールが有効になっていなくても開きます。サードパーティ製ファイアウォールまたはファイアウォールを使用していない場合は、手動でポートを開く必要があります。
エクスペリエンスメトリックの無効化
インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
除外
ストレート引用符で囲まれた、1つ以上のコンマ区切りの機能、サービス、またはテクノロジーのインストールを防止します。有効な値は次のとおりです。
Local Host Cache Storage (LocalDB): ローカルホストキャッシュに使用されるデータベースのインストールを防止します。このオプションは、サイトデータベースとして使用するためにSQL Server Expressがインストールされるかどうかに影響しません。
Smart Tools Agent: Citrix Smart Toolsエージェントのインストールを防止します。
注：
CU4以降、Smart Toolsはインストーラーに含まれなくなりました。以前のインストールから存在するSmart Toolsのインスタンスは変更されません。
/ヘルプ または /エイチ
コマンドヘルプを表示します。
/インストールディレクトリ <ディレクトリ>
コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
/ログパス <パス>
ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト = "%TEMP%\Citrix\XenDesktop Installer"
/リモートアシスタンス無効
Director のインストール時にのみ有効です。Windows リモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
/ノーリブート
インストール後の再起動を防止します。（ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。）
/nosql
Controller をインストールするサーバーへの Microsoft SQL Server Express のインストールを防止します。このオプションを省略すると、SQL Server Express がサイトデータベースとして使用するためにインストールされます。（このオプションは、ローカルホストキャッシュに使用される SQL Server Express LocalDB のインストールには影響しません。）
/サイレント または /パッシブ
インストール中にユーザーインターフェイスは表示されません。インストールプロセスの唯一の証拠は、Windows タスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
/remove オプション
/componentsオプションで指定されたコアコンポーネントを削除します。
/リムーブオール
インストールされているすべてのコアコンポーネントを削除します。
/センドエクスペリエンスメトリクス
インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合（または/disableexperiencemetricsが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。
/tempdir <ディレクトリ>
インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
/ゼナップ
XenAppをインストールします。このオプションが省略された場合、XenDesktop®がインストールされます。
例：コアコンポーネントのインストール
次のコマンドは、XenDesktop Controller、Studio、Citrix Licensing、およびSQL Server Expressをサーバーにインストールします。コンポーネント通信に必要なファイアウォールポートは自動的に開かれます。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
次のコマンドは、XenApp® Controller、Studio、およびSQL Server Expressをサーバーにインストールします。コンポーネント通信に必要なファイアウォールポートは自動的に開かれます。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
VDAをインストールするためのコマンドラインオプション
以下のオプションは、次の1つ以上のコマンドで有効です: XenDesktopVDASetup.exe、VDAServerSetup.exe、VDAWorkstationSetup.exe、またはVDAWorkstationCoreSetup.exe。
/ベースイメージ
VMにデスクトップOS用VDAをインストールする場合にのみ有効です。マスターイメージでPersonal vDiskを使用できるようにします。詳細については、「Personal vDisk」を参照してください。
このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。
/components <component>[,<component>]
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
VDA: バーチャル デリバリー エージェント
PLUGINS: シトリックス レシーバー for Windows (CitrixReceiver.exe)
たとえば、VDAをインストールし、Citrix Receiverをインストールしない場合は、/components vdaを指定します。
このオプションを省略すると、すべてのコンポーネントがインストールされます。
このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。そのインストーラーではCitrix Receiverをインストールできません。
/controllers “<controller> [<controller>] […]”
VDAが通信できるControllerのスペース区切りのFQDNを、引用符で囲んで指定します。/site_guidオプションと/controllersオプションの両方を指定しないでください。
/disableexperiencemetrics
インストール、アップグレード、または削除中に収集された分析がCitrixに自動的にアップロードされるのを防ぎます。
Framehawkポートを有効にする
Framehawkが使用するUDPポートを開きます。デフォルト = false
HDX 3D Proを有効にする
VDAをHDX™ 3D Proモードでインストールします。
/イネーブル_hdx_ポート
Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、VDAおよび有効な機能（Windowsリモートアシスタンスを除く）に必要なポートをWindowsファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でファイアウォールを構成する必要があります。ポート情報については、ネットワークポートを参照してください。
HDXアダプティブトランスポートが使用するUDPポートを開くには、/enable_hdx_udp_portsオプションと/enable_hdx_portsオプションを指定します。
/イネーブル_hdx_udp_ポート
Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、HDXアダプティブトランスポートに必要なUDPポートをWindowsファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でファイアウォールを構成する必要があります。ポート情報については、ネットワークポートを参照してください。
VDAが使用する他のポートを開くには、/enable_hdx_portsオプションと/enable_hdx_udp_portsオプションを指定します。
/enable_リアルタイムトランスポート
オーディオパケットにUDPを使用するかどうかを有効または無効にします（オーディオのリアルタイムオーディオトランスポート）。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。Windowsファイアウォールサービスが検出されたときにUDPポートを自動的に開く場合は、/enable_hdx_portsオプションを含めます。
/enable_リモートアシスタンス
Directorで使用するために、Windowsリモートアシスタンスのシャドウイング機能を有効にします。このオプションを指定すると、Windowsリモートアシスタンスはファイアウォールで動的ポートを開きます。
/exclude “<component>”[,”<component>”]
カンマ区切りの1つ以上のオプションコンポーネントのインストールを防止します。これらは引用符で囲みます。たとえば、MCSで管理されていないイメージにVDAをインストールまたはアップグレードする場合、Personal vDiskまたはMachine Identity Serviceコンポーネントは不要です。有効な値は次のとおりです。
Personal vDiskMachine Identity ServiceCitrix User Profile ManagerCitrix User Profile Manager WMI PluginCitrix Universal Print ClientCitrix Telemetry ServiceCitrix Personalization for App-V - VDA
Citrix Profile Managementをインストールから除外する（/exclude "Citrix User Profile Manager"オプションを使用する）と、Citrix DirectorでのVDAの監視とトラブルシューティングに影響します。ユーザーの詳細ページとエンドポイントページでは、パーソナライゼーションパネルとログオン期間パネルが失敗します。ダッシュボードページとトレンドページでは、平均ログオン期間パネルはProfile Managementがインストールされているマシンのみのデータを表示します。
サードパーティのユーザープロファイル管理ソリューションを使用している場合でも、CitrixはCitrix Profile Management Serviceをインストールして実行することを推奨します。Citrix Profile Management Serviceを有効にする必要はありません。
このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。このインストーラーは、これらの項目の多くを自動的に除外します。
/h or /help
コマンドヘルプを表示します。
/hdxflashv2only
セキュリティ強化のため、Flashリダイレクトのレガシーバイナリのインストールを防止します。
このオプションはグラフィカルインターフェイスでは利用できません。
/installdir <directory>
コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
/ログパス <パス>
ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト = "%TEMP%\Citrix\XenDesktop Installer"
このオプションはグラフィカルインターフェイスでは利用できません。
/マスターイメージ
VDAをVMにインストールする場合にのみ有効です。VDAをマスターイメージとして設定します。
このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。
/no_メディアファンデーション_確認
Microsoft Media Foundationがインストールされておらず、いくつかのHDXマルチメディア機能がインストールされず、動作しないことを認識します。このオプションを省略し、Media Foundationがインストールされていない場合、VDAのインストールは失敗します。ほとんどのサポートされているWindowsエディションには、Nエディションを除き、Media Foundationがすでにインストールされています。
/ノーシトリックスWDDM
WDDMドライバーを含まないWindows 7マシンでのみ有効です。Citrix WDDMドライバーのインストールを無効にします。
このオプションはグラフィカルインターフェイスでは利用できません。
/ノーデスクトップエクスペリエンス
Server OS 用 VDA をインストールする場合にのみ有効です。拡張デスクトップエクスペリエンス機能を有効にすることを防ぎます。この機能は、拡張デスクトップエクスペリエンス Citrix ポリシー設定でも制御されます。
/ノーリブート
インストール後の再起動を防止します。VDA は再起動するまで使用できません。
/ノーレジューム
デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、/noresume を指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。
/オプティマイズ
VM に VDA をインストールする場合にのみ有効です。ハイパーバイザー上の VM で実行されている VDA の最適化を有効にします。VM の最適化には、オフラインファイルの無効化、バックグラウンドデフラグの無効化、イベントログサイズの削減が含まれます。リモート PC アクセス展開では、このオプションを指定しないでください。詳細については、CTX224676 を参照してください。
/ポート番号 <port>
/reconfig オプションが指定されている場合にのみ有効です。VDA と Controller 間の通信を有効にするポート番号。以前に構成されたポートは、ポート 80 でない限り無効になります。
/クワイエット または /パッシブ
インストール中にユーザーインターフェイスは表示されません。インストールおよび構成プロセスの唯一の証拠は、Windows タスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
再構成
/portnumber、/controllers、または /enable_hdx_ports オプションと組み合わせて使用すると、以前に構成された VDA 設定をカスタマイズします。このオプションを /quiet オプションも指定せずに指定すると、VDA をカスタマイズするためのグラフィカルインターフェイスが起動します。
リモートPC
リモート PC アクセス展開の場合にのみ有効です。デスクトップ OS への以下のコンポーネントのインストールを除外します。
- Citrix App-V パーソナライゼーション
- Citrix ユーザープロファイルマネージャー
- Citrix ユーザープロファイルマネージャー WMI プラグイン
- マシンIDサービス
- パーソナル vDisk
このオプションは、VDAWorkstationCoreSetup.exe インストーラーを使用している場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。
/remove オプション
/components オプションで指定されたコンポーネントを削除します。
/リムーブオール
インストールされているすべてのVDAコンポーネントを削除します。
/センドエクスペリエンスメトリクス
インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合（または /disableexperiencemetrics オプションが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。
/サーバーVDI
サポートされているWindowsサーバーにデスクトップOS用VDAをインストールします。WindowsサーバーにサーバーOS用VDAをインストールする場合は、このオプションを省略してください。このオプションを使用する前に、Server VDI を参照してください。
このオプションは、フルプロダクトVDAインストーラーでのみ使用してください。このオプションは、グラフィカルインターフェイスでは利用できません。
/site_guid <ジーユーアイディー>
サイトのActive Directory組織単位 (OU) のグローバル一意識別子 (GUID)。Active Directoryを検出に使用している場合、これにより仮想デスクトップがサイトに関連付けられます (自動更新が推奨される既定の検出方法です)。サイトGUIDはStudioに表示されるサイトプロパティです。/site_guidと/controllersの両方のオプションを指定しないでください。
/tempdir <ディレクトリ>
インストール中に一時ファイルを保持するディレクトリ。既定値 = c:\Windows\Temp。
このオプションはグラフィカルインターフェイスでは利用できません。
/仮想マシン
VDAをVMにインストールする場合にのみ有効です。VMに渡されるBIOS情報により、VMが物理マシンとして表示されるため、インストーラーによる物理マシンの検出を上書きします。
このオプションはグラフィカルインターフェイスでは利用できません。
例：VDAのインストール
フルプロダクトインストーラーを使用したVDAのインストール
次のコマンドは、Desktop OS用VDAとCitrix Receiver™をVMの既定の場所にインストールします。このVDAはマスターイメージとして使用されます。VDAは、ドメイン「mydomain」内の「Contr-Main」という名前のサーバー上のControllerに最初に登録されます。VDAは、Personal vDisk、最適化機能、およびWindowsリモートアシスタンスを使用します。
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance
VDAWorkstationCoreSetupスタンドアロンインストーラーを使用したDesktop OS用VDAのインストール
次のコマンドは、Remote PCアクセスまたはVDI展開で使用するために、Desktop OSにコアサービスVDAをインストールします。Citrix Receiverおよびその他の非コアサービスはインストールされません。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ポート /enable_hdx_ports
コマンドラインを使用してUniversal Print Serverをインストールする
各プリントサーバーで、次のいずれかのコマンドを実行します。
- サポートされている32ビットオペレーティングシステムの場合：Citrixインストールメディアの
\x86\Universal Print Server\ディレクトリから、UpsServer_x86.msiを実行します。 - サポートされている64ビットオペレーティングシステムの場合：Citrixインストールメディアの
\x64\Universal Print Server\ディレクトリから、UpsServer_x64.msiを実行します。
プリントサーバーにUniversal Print Serverコンポーネントをインストールした後、プリンターのプロビジョニングのガイダンスを使用して構成します。