コマンドラインを使用したインストール
重要：
アップグレードをする予定で、現在のバージョンでPersonal vDiskまたはAppDiskソフトウェアを使用またはインストールしている場合は、「 PvD、AppDisk、およびサポートされていないホストの削除 」を参照してください。
Citrixは、ライセンスコンプライアンスを含む正当な利益のために、必要に応じて基本的なライセンスデータを収集します。 詳しくは、「Citrixライセンスデータ」を参照してください。
はじめに
この記事は、Windowsオペレーティングシステムがインストールされたマシンへのコンポーネントのインストールに適用されます。 LinuxオペレーティングシステムのVDAについては、「Linux Virtual Delivery Agent」を参照してください。
このアーティクルでは、製品のインストールコマンドの実行方法を説明します。 インストールを始める前に、「インストールの準備」を読んでください。 そのアーティクルには、利用できるインストーラーの説明があります。
コマンドの実行状態を確認して値を返すには、マシンの管理者であるか ［管理者として実行］ を使用する必要があります。 詳しくは、Microsoft社のコマンドに関するドキュメントを参照してください。
インストールコマンドを直接使用するだけでなく、製品ISOイメージにあるサンプルスクリプトを使用してActive DirectoryでマシンのVDAをインストール、アップグレード、または削除できます。 詳しくは、「スクリプトを使用したVDAのインストール」を参照してください。
このバージョンのCitrix Virtual Apps and DesktopsでサポートしていないバージョンのWindows OSにVDAをインストールまたはアップグレードしようとすると、メッセージが表示され、オプションに関する情報が示されます。 「以前のオペレーティングシステム」を参照してください。
Citrixがコンポーネントのインストールの結果を報告する方法については、「Citrixインストールリターンコード」を参照してください。
全製品インストーラーの使用
全製品インストーラーのコマンドラインインターフェイスへのアクセス：
- Citrixから製品パッケージをダウンロードします。 ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
- ファイルを解凍します。 必要な場合は、ISOファイルからDVDを作成します。
- ローカルの管理者アカウントを使って、インストール先のサーバーにログオンします。
- DVDをドライブに挿入するか、ISOファイルをマウントします。
-
製品メディアの
\x64\XenDesktop Setupディレクトリから適切なコマンドを実行します。コンポーネントをインストールするには： 「コアコンポーネントのインストールに使用されるコマンドラインオプション」セクションに記載されているオプションを指定して
XenDesktopServerSetup.exeを実行します。VDAをインストールするには： VDAをインストールするためのコマンドラインオプションに記載されているオプションを使用して
XenDesktopVDASetup.exeを実行します。StoreFrontをインストールするには：インストールメディアの
x64 > StoreFrontフォルダーでCitrixStoreFront-x64.exeを実行します。ユニバーサルプリントサーバーをインストールするには：「ユニバーサルプリントサーバーをインストールするためのコマンドラインオプション」のガイダンスに従ってください。
Federated Authentication Serviceをインストールするには： Citrixではグラフィカルインターフェイスを使用することをお勧めします
Sesssion Recordingをインストールするには： Session Recordingのガイダンスに従ってください。
Workspace Environment Managementをインストールするには： Workspace Environment Managementのガイダンスに従ってください。
Secure Private Accessをインストールするには：インストールメディアの
x64 > XenDesktopセットアップフォルダーでXenDesktopSPASetup.exeを実行します。 「Secure Private Accessをインストールするためのコマンドラインオプション」のガイダンスに従ってください。
コアコンポーネントのインストールに使用されるコマンドラインオプション
次のパラメーターは、XenDesktopServerSetup.exeコマンドを使用してコアコンポーネントをインストールするときに有効です。 オプションについて詳しくは、「コアコンポーネントのインストール」を参照してください。
-
/ceipoptin ceipoptin [,ceipoptin] …
Call Homeデータとカスタマーエクスペリエンス向上プログラム（CEIP）データの収集を有効にします。 以下の値を指定します：
-
DIAGNOSTIC：CitrixライセンスサーバーがCall Homeデータを収集できるようにするには、この値を選択します。 -
ANONYMOUS：Citrixライセンスサーバーが未識別のCEIPデータ（ユーザーを識別しない）を収集できるようにするには、この値を選択します。 -
NONE：CitrixライセンスサーバーがCEIPデータを収集できないようにするには、この値を選択します。
Call Homeデータの収集について詳しくは、「CitrixライセンスCall Home」を参照してください。
CEIPデータの収集について詳しくは、「Citrixライセンスカスタマーエクスペリエンス向上プログラム」を参照してください。
CEIPデータについて詳しくは、「CitrixライセンスCEIPデータ要素」を参照してください。
ライセンスサーバーのライセンスデータについて詳しくは、「Citrixライセンスデータ」を参照してください。
-
-
/components component [,component] …
インストールまたは削除するコンポーネントをコンマ区切りのリストで指定します。 以下の値を指定します：
-
CONTROLLER：Controller -
DESKTOPSTUDIO：Studio -
WEBSTUDIO：Web Studio -
DESKTOPDIRECTOR：Director -
LICENSESERVER：Citrixライセンスサーバー -
SECUREPRIVATEACCESS：Secure Private Access
このオプションを指定しない場合、すべてのコンポーネントがインストール（または、
/removeオプションも指定されている場合は削除）されます。(2003年以前のリリースでは、有効な値には
STOREFRONTが含まれていました。 バージョン2003以降では、「全製品インストーラーの使用」に記載されているStoreFront専用インストールコマンドを使用します ）。 -
-
/onlyprereqs
選択したコンポーネントの前提条件のみがインストールされます。 Citrix製品コンポーネントはインストールされません。
-
/configure_firewall
Windowsファイアウォールサービスが実行されている場合に（ファイアウォールが無効になっていても）、インストールされるコンポーネントで使用されるポートが開放されます。 サードパーティ製のファイアウォールを使用している場合は、適切なポートを手動で開く必要があります。
-
/disableexperiencemetrics
インストール、アップグレード、または削除中に収集される分析のCitrixへの自動アップロードが阻止されます。
-
/exclude “feature”[,”feature”]
二重引用符で囲まれた機能、サービス、またはテクノロジをインストールしません。複数の機能、サービス、またはテクノロジを指定する場合は、コンマで区切って、それぞれを直線の二重引用符で囲みます。 以下の値を指定します：
-
"Local Host Cache Storage (LocalDB)"：ローカルホストキャッシュに使用されるデータベースのインストールが阻止されますこのオプションは、サイトデータベースとして使うためにSQL Server Expressがインストールされているかには影響しません。 このオプションは、サイトデータベースとして使うためにSQL Server Expressがインストールされているかには影響しません。
-
-
/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がサイトデータベースとして使用するためにインストールされます。
このオプションは、ローカルホストキャッシュに使用されるSQL Server Express LocalDBのインストールには影響しません。
-
/quietまたは/passive
ユーザーインターフェイスを表示せずにインストールを実行します。 インストールプロセスは、Windowsタスクマネージャーにのみ表示されます。 このオプションを指定しない場合、インストールウィザードが表示されます。
-
/remove
/componentsオプションで指定したコアコンポーネントを削除します。 -
/removeall
インストール済みのすべてのコアコンポーネントを削除します。
-
/SKIPHDXDRIVERCHECK
VDAメタインストーラーへのHDXドライバーのチェックをスキップします。
-
/sendexperiencemetrics
Citrix Insight Servicesへのインストール、アップグレード、または削除中に収集される分析が自動的に送信されます。 これが省略される場合（または
/disableexperiencemetricsが指定される場合）、分析はローカルで収集されますが、自動的には送信されません。 -
/tempdir directory
インストール時に一時ファイルを作成するディレクトリを指定します。 デフォルト= c:\Windows\Temp。
-
/xenapp
Citrix Virtual Appsをインストールします。 このオプションを指定しない場合、Citrix Virtual Apps and Desktopsがインストールされます。
コアコンポーネントのインストールの例
次のコマンドを実行すると、Delivery 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
次のコマンドを実行すると、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以降の新規インストールを実行する場合は、最初の手順としてライセンスサーバーを最新バージョン（バージョン11.2.17ビルド51000）に更新します。 次に、Delivery Controllerをアップグレードします。 これを行わないと、コマンドラインによるインストールとアップグレードが失敗します。 次のコマンドを実行して、ライセンスサーバーと、Delivery Controller、Web Studio、Citrix Directorなどのコンポーネントをアップグレードします（マウントされたISOの\x64フォルダー内にあることを前提としています）。
-
以下を実行します：
\x64\Licensing\CitrixLicensing.exe /quiet <!--NeedCopy-->ライセンスバイナリをいずれかのローカル ドライブにコピーした場合は、次のコマンドを実行します：
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log <!--NeedCopy--> -
以下を実行します：
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL <!--NeedCopy-->
スタンドアロンVDAインストーラーの使用
ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。 インストールは、管理者権限（または ［管理者として実行］）で実行する必要があります。
- Citrixから適切なパッケージをダウンロードします：
- マルチセッションOS Virtual Delivery Agent：
VDAServerSetup_xxxx.exe - シングルセッションOS Virtual Delivery Agent：
VDAWorkstationSetup_xxxx.exe - シングルセッションOS Core Services Virtual Delivery Agent：
VDAWorkstationCoreSetup_xxxx.exe
- マルチセッションOS Virtual Delivery Agent：
-
まず、パッケージから既存のディレクトリにファイルを抽出して、インストールコマンドを実行するか、または通常どおりにパッケージを実行します。
インストール前にファイルを展開するには、絶対パスを指定して
/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のインストールに使用されるコマンドラインオプション
次のオプションは、次の各コマンドの1つ以上で使用できます：VDAServerSetup_xxxx.exe、VDAWorkstationSetup_xxxx.exe、およびVDAWorkstationCoreSetup_xxxx.exe。
オプションについて詳しくは、「VDAのインストール」を参照してください。
-
/components component[,component]
インストールまたは削除するコンポーネントをコンマ区切りのリストで指定します。 以下の値を指定します：
-
VDA：Virtual Delivery Agent -
PLUGINS：Windows向けCitrix Workspaceアプリ
VDAおよびWindows向けCitrix Workspaceアプリをインストールするには、「
/components vda,plugins」と指定するか、いずれのコンポーネントも指定しません。 コンポーネントが指定されていない場合は、デフォルトでVDAのみがインストールされます。VDAのみをインストールして、Citrix Workspaceアプリのインストールを除外するには、「
/components vda」と指定します。このオプションは、
VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用している場合無効です。 このインストーラーでは、Citrix Workspaceアプリをインストールできません。 -
-
/onlyprereqs
選択したコンポーネントの前提条件のみがインストールされます。 Citrix製品コンポーネントはインストールされません。
-
/controllers “controller [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アダプティブトランスポートに使用するポートがWindowsファイアウォールで開放されます。 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ウォールで開放されます。 Windows以外のファイアウォールを使用している場合は、手作業でファイアウォールを構成する必要があります。
-
/exclude “component”[,”component”]
二重引用符で囲まれた、オプションコンポーネントをインストールしません。複数のコンポーネントを指定する場合は、コンマで区切って、それぞれ直線の二重引用符で囲みます。 たとえば、MCSが管理していないイメージ上でVDAをインストールまたはアップグレードする場合、Machine Identity Serviceコンポーネントは必要ありません。 有効な値は次のとおりです：
マルチセッションOS シングルセッションOS シングルセッションOS Core Services Citrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Backup and RestoreCitrix Backup and RestoreCitrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Personalization for App-V - VDACitrix MCS IODriverCitrix MCS IODriverCitrix Telemetry ServiceCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Universal Print ClientCitrix Profile ManagementCitrix Profile ManagementCitrix Vda Log Capture ServiceCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCSE ComponentCitrix Rendezvous V2Citrix Rendezvous V2Director VDA Plug-inCitrix Telemetry ServiceCitrix Telemetry ServiceMachine Management ProviderCitrix Universal Print ClientCitrix Universal Print ClientVDA Monitor Plug-inCitrix Vda Log Capture ServiceCitrix Vda Log Capture ServiceVDA WMI Proxy Plug-inCitrix VDA Upgrade AgentCitrix VDA Upgrade AgentCSE ComponentCSE ComponentDirector VDA Plug-inDirector VDA Plug-inMachine Identity ServiceMachine Identity ServiceMachine Management ProviderMachine Management ProviderVDA Monitor Plug-inUser Personalization LayerVDA WMI Proxy Plug-inVDA Monitor Plug-inVDA WMI Proxy Plug-inCitrix App Protection ComponentCitrix App Protection ComponentCitrix App Protection ComponentCitrix HyperV Filter DriverCitrix HyperV Filter DriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Personalization for App-V - VDAインストール（
/exclude "Citrix Profile Management"）からCitrix Profile Managementを除くと、Citrix Directorを使ったVDAの監視やトラブルシューティングに影響があります。 ［ユーザーの詳細］ ページの［個人設定］パネル、および ［エンドポイント］ ページの［ログオン処理時間］パネルに不具合が発生します。 ［ダッシュボード］ ページと ［傾向］ ページでは、Profile Managementがインストールされているマシンについてのデータしか［平均ログオン処理時間］パネルに表示されません。サードパーティのユーザープロファイル管理ソリューションを使用している場合でも、Citrix Profile Management Serviceをインストールして実行することをCitrixではお勧めします。 Citrix Profile Management Serviceの有効化は、必須ではありません。
/excludeおよび/includeadditionalの両方に同じコンポーネント名を指定した場合、そのコンポーネントはインストールされません。このオプションは、
VDAWorkstationCoreSetup.exeインストーラーを使用している場合無効です。 そのインストーラーは、これらの項目の多くを自動的に除外します。 -
/h または /help
コマンドのヘルプを表示します。
-
/includeadditional “component”[,”component”]
インストールするオプションコンポーネントを1つ以上、それぞれ直線の二重引用符で囲みコンマ区切りで指定します。 このオプションを使用すると、リモートPCアクセス展開を作成する場合に、デフォルトでは含まれない他のコンポーネントをインストールできます。 有効な値は次のとおりです：
マルチセッションOS シングルセッションOS Citrix Backup and RestoreCitrix Backup and RestoreCitrix MCS IODriverCitrix MCS IODriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Profile ManagementCitrix Profile ManagementCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCitrix Rendezvous V2Citrix Rendezvous V2Citrix VDA Upgrade AgentCitrix VDA Upgrade AgentCitrix Web Socket Vda Registration ToolCitrix Web Socket Vda Registration ToolMachine Identity ServiceMachine Identity ServiceUser 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をインストールする場合にのみ有効です。 他のマシンの作成に使用するイメージとして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のメタインストーラーによって検索されたレジストリキーに設定値が存在しない可能性があります。 インストールプロセスを開始する前に
SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersionレジストリキーをチェックして、値が存在し空でないことを確認してください。 -
/nodesktopexperience
拡張デスクトップエクスペリエンス機能は使用できなくなりました。 このオプション（およびポリシー設定）は、指定しても無視されます。
マルチセッションOS対応VDAをインストールする場合にのみ有効です。 デスクトップエクスペリエンス拡張機能を無効にします。 この機能の有効/無効は、Citrixポリシー設定の ［拡張デスクトップエクスペリエンス］ でも制御できます。
-
/noreboot
インストール後の再起動を無効にします。 VDAは、再起動後にのみ使用できます。
-
/noresume
デフォルトでは、インストール中にマシンの再起動が必要になった場合、再起動が完了すると自動的にインストーラーが再開します。 デフォルトを上書きするには、
/noresumeを指定します。 これは、メディアを再マウントする必要がある場合、または自動インストール中に情報をキャプチャする必要がある場合に役立ちます。 -
/physicalmachine
リモートPCのインストールには、この引数を
/remotepcとともに使用します。 そうしないと、特定のユーザーシナリオでVDAが正常に動作しない場合があります。 -
/portnumber port
/reconfigオプションを指定する場合にのみ有効です。 Virtual Delivery AgentとController間の通信で使用されるポート番号を変更します。 変更前のポートは無効になります（ポート80を除く）。 -
/proxyconfig “アドレスまたはPACファイルパス”
環境内のGatewayサービスなどで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または/passive
ユーザーインターフェイスを表示せずにインストールを実行します。 インストールおよび構成プロセスは、Windowsタスクマネージャーにのみ表示されます。 このオプションを指定しない場合、インストールウィザードが表示されます。
-
/reconfigure
インストール済みのVirtual Delivery Agent設定をカスタマイズします。
/portnumber、/controllers、または/enable_hdx_portsオプションと一緒に使用します。/quietオプションを指定しない場合は、VDAをカスタマイズするためのグラフィカルインターフェイスが開きます。 -
/remotepc
リモート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とともにCitrix Workspaceアプリも削除します。
-
/sendexperiencemetrics
Citrix Insight Servicesへのインストール、アップグレード、または削除中に収集される分析が自動的に送信されます。 これが省略される場合（または
/disableexperiencemetricsが指定される場合）、分析はローカルで収集されますが、自動的には送信されません。 -
/servervdi
サポートされるWindowsマルチセッションマシンにシングルセッションOS対応VDAをインストールします。 WindowsマルチセッションマシンにマルチセッションOS対応VDAをインストールするときにこのオプションを省略します。
このオプションを使用する前に、「サーバー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情報を仮想マシンに渡して物理マシンとして振る舞うようにします。
このオプションはグラフィカルインターフェイスでは使用できません。
-
/xendesktopcloud
VDAがCitrix DaaS（Citrix Cloud）展開にインストールされていることを示します。
VDAのインストールの例
フル製品インストーラーを使用してVDAをインストールします：
次のコマンドを実行すると、仮想マシン上のデフォルトの場所にシングルセッションOS対応VDAおよび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 /includeadditional "user personalization layer" /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
VDAのトラブルシューティング
-
デリバリーグループのStudio表示では、［詳細］ ペインの ［インストール済みVDAのバージョン］ エントリがマシンにインストールされているバージョンではないことがあります。 マシンのWindowsの［プログラムと機能］には、VDAの実際のバージョンが表示されます。
-
インストール後、VDAはDelivery Controllerに登録されるまでユーザーにアプリやデスクトップを配信することはできません。
VDAの登録方法および登録の問題のトラブルシューティングについては、「VDA登録」を参照してください。
ユニバーサルプリントサーバーをインストールするためのコマンドラインオプション
次のオプションは、XenDesktopPrintServerSetup.exeコマンドで有効です。
- /enable_upsserver_port
このオプションが指定されていない場合、インストーラーはグラフィカルインターフェイスからファイアウォールページを表示します。 Automaticallyを選択すると、インストーラーは自動的にWindowsファイアウォール規則を追加し、Manuallyを選択すると管理者が手動でファイアウォールを構成できるようにします。
プリントサーバーにこのソフトウェアをインストールした後で、「プリンターのプロビジョニング」の説明に従って構成します。
Secure Private Accessをインストールするためのコマンドラインオプション
次のオプションはどちらでも有効です：
- CVADインストーラー：
XenDesktopSPASetup.exe - SPAオンプレミスインストーラー：
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_ports
Windowsファイアウォールサービスが検出された場合に（ファイアウォールが無効になっていても）、Secure Private Accessに必要なポートがWindowsファイアウォールで開放されます。 Windows以外のファイアウォールを使用している場合は、手作業でファイアウォールを構成する必要があります。 ポートについて詳しくは、「ネットワークポート」を参照してください。
-
/nosql
Secure Private Accessのインストール先サーバーにMicrosoft SQL Server Expressをインストールしない場合に指定します。 このオプションを指定しない場合、SQL Server Expressがサイトデータベースとして使用するためにインストールされます。
-
/helpまたは/hまたは/?
コマンドのヘルプを表示します
-
/noreboot
インストール後の再起動を無効にします。 Secure Private Accessは再起動するまで使用できません。
-
/quietまたは/passive
ユーザーインターフェイスを表示せずにインストールを実行します。 インストールおよび構成プロセスは、Windowsタスクマネージャーにのみ表示されます。 このオプションを指定しない場合、インストールウィザードが表示されます。
-
/remove
Secure Private Accessを削除します。
オプションについて詳しくは、「Secure Private Accessインストーラー」を参照してください。
追加情報
Citrixがコンポーネントのインストールの結果を報告する方法については、「Citrixインストールリターンコード」を参照してください。