コマンドラインを使用したインストール
重要:
アップグレードを行う場合で、現在のバージョンが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インストールのリターンコード」を参照してください。
フルプロダクトインストーラーの使用
フルプロダクトインストーラーのコマンドラインインターフェイスにアクセスするには:
- Citrixから製品パッケージをダウンロードします。ダウンロードサイトにアクセスするには、Citrixアカウントの資格情報が必要です。
- ファイルを解凍します。必要に応じて、ISOファイルをDVDに書き込みます。
- ローカル管理者アカウントを使用して、コンポーネントをインストールするサーバーにログオンします。
- DVDをドライブに挿入するか、ISOファイルをマウントします。
-
メディアの
\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 フォルダー内にいると仮定します)。
-
次を実行します。
\x64\Licensing\CitrixLicensing.exe /quiet <!--NeedCopy-->Licensingバイナリをローカルドライブのいずれかにコピーした場合は、次のコマンドを実行します。
\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: 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.exe、VDAWorkstationSetup_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製品コンポーネントはインストールされません。
-
/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アダプティブトランスポートが使用する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™ドライバーのチェックをスキップします。
-
/exclude “component”[,”component”]
1つ以上のコンマ区切りのオプションコンポーネントのインストールを防止します。各コンポーネントはストレート引用符で囲みます。たとえば、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 deviceTRUST®Citrix deviceTRUSTCitrix deviceTRUSTuberAgent®uberAgentuberAgentCitrix Secure Access ClientCitrix Secure Access ClientCitrix Secure Access ClientCitrix Workspace Environment Management™ AgentCitrix Workspace Environment Management AgentCitrix Workspace Environment Management AgentCitrix 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 - VDASession Recording AgentSession Recording AgentElastic App LayeringCitrix Assistant AppCitrix 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 “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を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でない限り無効になります。 -
/proxyconfig “address 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インストール用のコマンドラインオプション
次のオプションは、両方で有効です。
- CVADインストーラー:
XenDesktopSPASetup.exe - 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インストールリターンコード」を参照してください。