コマンドラインを使用してインストールする
重要:
アップグレードする場合で、現在のバージョンで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をインストールするには: Citrixはグラフィカルインターフェイスの使用を推奨します。
Session Recordingをインストールするには: Session Recordingのガイダンスに従ってください。
ワークスペース環境管理をインストールするには: ワークスペース環境管理 のガイダンスに従ってください。
Secure Private Accessをインストールするには: インストールメディアの
x64 > XenDesktopSetupフォルダーで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ライセンスカスタマーエクスペリエンス向上プログラムを参照してください。
CEIPデータについて詳しくは、「Citrix Licensing CEIPデータ要素」を参照してください。
License Serverのライセンスデータについて詳しくは、「Citrix Licensing Data」を参照してください。
-
-
/コンポーネント コンポーネント [,component] …
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
CONTROLLER: コントローラー -
DESKTOPSTUDIO: スタジオ -
WEBSTUDIO: ウェブスタジオ -
DESKTOPDIRECTOR: ディレクター -
LICENSESERVER: Citrixライセンスサーバー -
SECUREPRIVATEACCESS: セキュア プライベート アクセス
-
VDAのみをインストールし、他のCitrixコンポーネントのインストールを除外するには、/components vdaを指定します。
このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合は無効です。このインストーラーは、Citrix Workspaceアプリまたは他のCitrixコンポーネントをインストールできません。
このオプションを省略すると、すべてのコンポーネントがインストールされます(/removeオプションも指定されている場合は削除されます)。
(2003年より前のリリースでは、有効な値にSTOREFRONTが含まれていました。バージョン2003以降では、Use the full-product installerで説明されている専用のStoreFrontインストールコマンドを使用してください)。
-
/onlyprereqs
選択したコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
-
ファイアウォールの構成
Windows Firewall Serviceが実行されている場合、ファイアウォールが有効になっていなくても、インストールされるコンポーネントで使用されるWindowsファイアウォールのすべてのポートを開きます。サードパーティ製ファイアウォールまたはファイアウォールを使用していない場合は、手動でポートを開く必要があります。
-
エクスペリエンスメトリックを無効にする
インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
-
/help または /h のいずれか
コマンドヘルプを表示します。
-
ハードウェアチェックの失敗を無視
ハードウェアチェックが失敗した場合でも(例えば、RAM不足のため)、Delivery Controllerのインストールまたはアップグレードを続行できるようにします。詳細については、「ハードウェアチェック」を参照してください。
-
サイトテストの失敗を無視
Controllerのアップグレード中にのみ有効です。通常、サイトテストの失敗は無視され、アップグレードは続行されます。省略された場合(またはfalseに設定された場合)、サイトテストの失敗があると、アップグレードを実行せずにインストーラーが失敗します。デフォルト = false
アップグレード中に、サポートされていないSQL Serverバージョンが検出された場合、このオプションは無視されます。詳細については、「SQL Serverバージョンチェック」を参照してください。
-
インストールディレクトリ ディレクトリ
コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
-
ログパス パス
ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト =
TEMP%\Citrix\XenDesktop Installer -
リモートアシスタンスなし
Directorのインストール時にのみ有効です。Windowsリモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
-
再起動なし
インストール後の再起動を防止します。(ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。)
-
再開なし
デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。このデフォルトを上書きするには、
/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。 -
/nosql を指定する
Controller をインストールするサーバーへの Microsoft SQL Server Express のインストールを防止します。このオプションを省略すると、SQL Server Express がサイトデータベースとして使用するためにインストールされます。
このオプションは、ローカルホストキャッシュに使用される SQL Server Express LocalDB のインストールには影響しません。
-
/quiet or /passive
インストール中にユーザーインターフェイスは表示されません。インストールプロセスの唯一の証拠は、Windows タスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
削除
/componentsオプションで指定されたコアコンポーネントを削除します。 -
すべて削除
インストールされているすべてのコアコンポーネントを削除します。
-
/センドエクスペリエンスメトリクス
インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションを省略した場合(または
/disableexperiencemetricsが指定された場合)、分析データはローカルで収集されますが、自動的には送信されません。 -
/tempdir ディレクトリ
インストール中に一時ファイルを保持するディレクトリ。デフォルト = 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フォルダー内にいることを前提とします)。
-
次を実行します。
\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 バーチャル デリバリー エージェント:
VDAServerSetup_xxxx.exe - シングルセッションOS バーチャル デリバリー エージェント:
VDAWorkstationSetup_xxxx.exe - シングルセッションOS コアサービス バーチャル デリバリー エージェント:
VDAWorkstationCoreSetup_xxxx.exe
- マルチセッションOS バーチャル デリバリー エージェント:
-
まずパッケージから既存のディレクトリにファイルを抽出し、その後インストールコマンドを実行するか、または単にパッケージを実行します。
ファイルをインストールする前に抽出するには、絶対パスを指定して
/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: シトリックス セキュア アクセス™ クライアント -
PLUGINS: Windows向けシトリックス ワークスペース™ アプリ -
UPL: Citrixユーザーパーソナライゼーションレイヤー
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 コンポーネント[,コンポーネント]
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
VDA: バーチャル デリバリー エージェント -
PLUGINS: Windows向けシトリックス ワークスペース アプリ -
CSA: シトリックス セキュア アクセス クライアント -
UPL: シトリックス ユーザー パーソナライゼーション レイヤー
-
VDAとCitrix Workspaceアプリ for Windowsをインストールするには、/components vda, plugins, CSA, UPLを指定するか、またはコンポーネントをまったく指定しないでください。コンポーネントが指定されていない場合、デフォルトではVDAのみがインストールされます。
VDAのみをインストールし、Citrix Workspaceアプリのインストールを除外するには、/components vdaを指定します。
このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用している場合は無効です。そのインストーラーはCitrix Workspaceアプリをインストールできません。
-
前提条件のみ
選択したコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
-
コントローラー “コントローラー [コントローラー]”
VDAが通信できるControllerのFQDNをスペースで区切り、引用符で囲んで指定します。
/site_guidオプションと/controllersオプションの両方を指定しないでください。 -
エクスペリエンスメトリックを無効にする
インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
-
HDXポートを有効にする
Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、VDAおよび有効な機能(Windowsリモートアシスタンスを除く)に必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。
HDXアダプティブトランスポートが使用するUDPポートを開くには、この
/enable_hdx_portsオプションに加えて、/enable_hdx_udp_portsオプションを指定します。 -
HDX UDPポートを有効にする
Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、HDXアダプティブトランスポートが使用するUDPポートをWindowsファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でファイアウォールを構成する必要があります。ポート情報については、ネットワークポートを参照してください。
VDAが使用する追加のポートを開くには、この
/enable_hdx_udp_portsオプションに加えて、/enable_hdx_portsオプションを指定します。 -
/enable_hdx_tls_dtls
HDX™ Direct V1用にTCPおよびUDPポート443を開きます。
-
/リアルタイムトランスポートを有効にする
オーディオパケットにUDPを使用できるようにするか、または無効にします(オーディオ用のRealTime Audio Transport)。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。Windowsファイアウォールサービスが検出されたときにUDPポートを自動的に開きたい場合は、
/enable_hdx_portsオプションを含めます。 -
/リモートアシスタンスを有効にする
Directorで使用するために、Windowsリモートアシスタンスのシャドウイング機能を有効にします。このオプションを指定すると、Windowsリモートアシスタンスはファイアウォールで動的ポートを開きます。
-
/enablerestore or /enablerestorecleanup
(シングルセッションVDAにのみ有効)VDAのインストールまたはアップグレードが失敗した場合に、復元ポイントへの自動復帰を有効にします。
インストール/アップグレードが正常に完了した場合:
-
/enablerestorecleanupは、インストーラーに復元ポイントを削除するよう指示します。 -
/enablerestoreは、インストーラーに、使用されなかった場合でも復元ポイントを保持するよう指示します。
詳細については、インストールまたはアップグレードの失敗時の復元を参照してください。
-
-
/ENABLE_SECURE_DEFAULTS
より安全な初期設定のために、さまざまな機能のデフォルト設定を有効から無効に変更します。関連する機能は、クライアントドライブリダイレクト、特殊フォルダーリダイレクト、ドラッグアンドドロップ、クライアントTWAINデバイスリダイレクト、クライアントUSBプラグアンドプレイデバイスリダイレクト、クライアントプリンターリダイレクト、クライアントクリップボードリダイレクト、およびクライアントマイクのリダイレクトです。
-
イネーブル_エスエス_ポート
Windows Firewallサービスが検出された場合、ファイアウォールが有効になっていなくても、画面共有に必要なWindows Firewallのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。
-
スキップエイチディーエックスドライバーチェック
VDAメタインストーラーへのHDX™ドライバーのチェックをスキップします。
-
/exclude “コンポーネント”[,”コンポーネント”]
コンマで区切られた1つ以上のオプションコンポーネントのインストールを防止します。各コンポーネントは引用符で囲まれています。たとえば、MCSによって管理されていないイメージにVDAをインストールまたはアップグレードする場合、Machine Identity Serviceコンポーネントは不要です。有効な値は次のとおりです。
マルチセッションOS シングルセッションOS シングルセッションOSコアサービス 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 deviceTRUSTCitrix deviceTRUSTCitrix deviceTRUSTuberAgentuberAgentuberAgentCitrix 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 - VDACitrix 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 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 インストールディレクトリ
コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
-
/インストール_mcsio_ドライバー
使用しないでください。代わりに
/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 ウェブソケットトークン
Web Socket VDAを作成します。WebSocketTokenは、必要なトークンを表します。
-
/websockettokenfile ウェブソケットトークンが格納されたファイル
Web Socket VDA を作成します。FileContainingWebSockToken は、必要なトークンが格納されているファイルを示します。
-
ウェブソケットトークンSTDIN <ウェブソケットトークン
Web Socket VDAを作成します。<WebSocketTokenは、STDINによって渡される必要なトークンを表します。
-
no_メディアファンデーション_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 が予期したとおりに動作しない可能性があります。 -
/ポートナンバー ポート
/reconfigオプションが指定されている場合にのみ有効です。VDA と Controller 間の通信を有効にするポート番号。以前に構成されたポートは、ポート 80 でない限り無効になります。 -
/proxyconfig “アドレスまたはPACファイルパス”
環境で 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 をカスタマイズするためのグラフィカルインターフェイスが起動します。 -
/リモートPC
リモートPCアクセス展開(シングルセッションOS)またはブローカー接続(マルチセッションOS)にのみ有効です。追加コンポーネントのインストールは除外されます(
/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。このオプションは、
VDAWorkstationCoreSetup.exeインストーラーを使用している場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。/remotepcは/servervdiオプションと互換性がありません。 -
/アンインストール
/componentsオプションで指定されたコンポーネントを削除します。 -
/AppDisk_確認の削除
インストールされている場合、AppDisks™ VDAプラグインをアンインストールすることをVDAインストーラーに許可します。
-
/PVD_確認の削除
インストールされている場合、Personal vDiskをアンインストールすることをVDAインストーラーに許可します。
-
/すべてアンインストール
VDAを削除します。Citrix Workspaceアプリ(インストールされている場合)は削除しません。
-
/CWAと共にすべてアンインストール
VDAとともにCWAを削除します。
-
/エクスペリエンスメトリックを送信
インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合(または
/disableexperiencemetricsオプションが指定された場合)、分析データはローカルで収集されますが、自動的には送信されません。 -
/サーバーVDI
サポートされているWindowsマルチセッションマシンに、シングルセッションOS用VDAをインストールします。WindowsマルチセッションマシンにマルチセッションOS用VDAをインストールする場合は、このオプションを省略してください。
このオプションを使用する前に、「Server VDI」を参照してください。
このオプションは、フルプロダクトVDAインストーラーでのみ使用してください。
-
/site_guid ジーユーアイディー
サイトのActive Directory組織単位(OU)のグローバル一意識別子。Active Directoryを検出に使用している場合(自動更新が推奨される既定の検出方法です)、これにより仮想デスクトップがサイトに関連付けられます。サイトGUIDは、Studioに表示されるサイトプロパティです。
/site_guidオプションと/controllersオプションの両方を指定しないでください。 -
/tempdir ディレクトリ
インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
このオプションはグラフィカルインターフェイスでは利用できません。
-
/仮想マシン
VDAをVMにインストールする場合にのみ有効です。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 Accessまたは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登録」(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/manage-deployment/vda-registration.html)を参照してください。
Universal Print Serverをインストールするためのコマンドラインオプション
次のオプションは、XenDesktopPrintServerSetup.exeコマンドで有効です。
- /enable_upsserver_port
このオプションが指定されていない場合、インストーラーはグラフィカルインターフェイスから「ファイアウォール」ページを表示します。「自動」を選択すると、インストーラーがWindowsファイアウォール規則を自動的に追加します。または「手動」を選択すると、管理者がファイアウォールを手動で構成できます。
印刷サーバーにソフトウェアをインストールした後、「Citrix Universal Print Server (UPS)」(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/printing/configuration/citrix-universal-print-servers)のガイダンスに従ってUniversal Print Serverを構成します。
Secure Private Accessをインストールするためのコマンドラインオプション
次のオプションは両方で有効です。
- CVADインストーラー:
XenDesktopSPASetup.exe - SPAオンプレミスインストーラー:
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_ports
Windowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、Secure Private Accessに必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」(/ja-jp/tech-zone/build/tech-papers/citrix-communication-ports.html#citrix-virtual-apps-and-desktops)を参照してください。
-
nosql オプション
Secure Private Access をインストールするサーバーへの Microsoft SQL Server Express のインストールを防止します。このオプションを省略すると、サイトデータベースとして使用するために SQL Server Express がインストールされます。
-
/help または /h または /?
コマンドのヘルプを表示します
-
/noreboot
インストール後の再起動を防止します。Secure Private Access は、再起動するまで使用できません。
-
/クワイエット または /パッシブ
インストール中にユーザーインターフェイスは表示されません。インストールおよび構成プロセスの唯一の証拠は、Windows タスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/削除
セキュアプライベートアクセスを削除します。
オプションの詳細については、Secure Private Access インストーラーを参照してください。
詳細情報
Citrix がコンポーネントインストールの結果を報告する方法については、Citrix インストールリターンコードを参照してください。