コマンドラインを使用したインストール
重要:
-
アップグレードする場合で、現在のバージョンがPersonal vDiskまたはAppDisksソフトウェアを使用しているか、インストールされている場合は、「PvD、AppDisks、およびサポートされていないホストの削除」を参照してください。
-
Citrixは、ライセンスコンプライアンスを含む正当な利益のために、必要に応じて基本的なライセンスデータを収集します。詳細については、「Citrixライセンスデータ」を参照してください。
はじめに
この記事は、Windowsオペレーティングシステムを搭載したマシンにコンポーネントをインストールする場合に適用されます。Linuxオペレーティングシステム用VDAについては、「Linux Virtual Delivery Agents」を参照してください。
この記事では、製品のインストールコマンドを発行する方法について説明します。インストールを開始する前に、「インストールの準備」を確認してください。この記事には、利用可能なインストーラーの説明が含まれています。
コマンド実行の進行状況と戻り値を確認するには、元の管理者であるか、管理者として実行を使用する必要があります。詳細については、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をインストールするには:XenDesktopVDASetup.exeを実行します。オプションについては、VDAのインストール用コマンドラインオプション を参照してください。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 > XenDesktopSetupフォルダーでXenDesktopSPASetup.exeを実行します。Secure Private Accessのインストールに関するコマンドラインオプションのガイダンスに従ってください。
コアコンポーネントのインストール用コマンドラインオプション
XenDesktopServerSetup.exeコマンドを使用してコアコンポーネントをインストールする場合、以下のパラメーターオプションが有効です。オプションの詳細については、コアコンポーネントのインストールを参照してください。
注:
-
コアコンポーネントをインストールするためのコマンドラインオプションを使用している間は、
/excludeを使用しないでください。 -
/componentsを使用して1つのコンポーネントをアップグレードすると、他のコンポーネントもアップグレードされる場合があります。これは、異なるコンポーネント間の潜在的な互換性の問題を回避するためです。 -
1つのコンポーネントのみをアップグレードする場合は、そのコンポーネントの個別のインストーラーを使用してください。展開のアップグレードを参照してください。
-
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を参照してください。License Serverのライセンスデータの詳細については、Citrix Licensing Dataを参照してください。 -
-
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
CONTROLLER: コントローラー -
DESKTOPSTUDIO: スタジオ -
WEBSTUDIO: ウェブスタジオ -
DESKTOPDIRECTOR: ディレクター -
LICENSESERVER: Citrix ライセンスサーバー -
SECUREPRIVATEACCESS: セキュア プライベート アクセス
このオプションを省略すると、すべてのコンポーネントがインストールされます (/removeオプションも指定されている場合は、削除されます)。(2003年より前のリリースでは、有効な値にSTOREFRONTが含まれていました。バージョン2003以降では、Use the full-product installerに記載されている専用のStoreFrontインストールコマンドを使用してください)。 -
-
/configure_firewallWindowsファイアウォールサービスが実行されている場合、ファイアウォールが有効になっていなくても、インストールされているコンポーネントで使用されるWindowsファイアウォールのすべてのポートを開きます。サードパーティ製ファイアウォールまたはファイアウォールを使用していない場合は、手動でポートを開く必要があります。
-
/ディスエーブルエクスペリエンスメトリクスインストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
-
/help または /hコマンドのヘルプを表示します。
-
/ignore\_hw\_check\_failureハードウェアチェックが失敗した場合でも (たとえば、RAM不足のため)、Delivery Controllerのインストールまたはアップグレードを続行できます。詳しくは、Hardware checkを参照してください。
-
/ignore\_site\_test\_failureコントローラーのアップグレード中にのみ有効です。通常、サイトテストの失敗は無視され、アップグレードは続行されます。省略された場合(またはfalseに設定された場合)、サイトテストの失敗があると、アップグレードを実行せずにインストーラーが失敗します。デフォルト = falseアップグレード中に、サポートされていないSQL Serverバージョンが検出された場合、このオプションは無視されます。詳細については、SQL Serverのバージョンチェックを参照してください。
-
/installdir ディレクトリコンポーネントがインストールされる既存の空のディレクトリ。デフォルト =
c:\Program Files\Citrix。 -
/logpath パスログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト =
TEMP%\Citrix\XenDesktop Installer -
/no_remote_assistanceDirector のインストール時にのみ有効です。Windows リモートアシスタンスを使用するユーザーシャドウイング機能を無効にします。
-
再起動なしインストール後の再起動を防止します。(ほとんどのコアコンポーネントでは、再起動はデフォルトで有効になっていません。)
-
再開しないデフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、
/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。 -
ノースキューエルコントローラーをインストールするサーバーへのMicrosoft SQL Server Expressのインストールを防止します。このオプションが省略された場合、SQL Server Expressはサイトデータベースとして使用するためにインストールされます。このオプションは、ローカルホストキャッシュに使用される SQL Server Express LocalDB のインストールには影響しません。
-
サイレント または パッシブインストール中にユーザーインターフェイスは表示されません。インストールプロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/リムーブ
/componentsオプションで指定されたコアコンポーネントを削除します。 -
/リムーブオールインストールされているすべてのコアコンポーネントを削除します。
-
/センドエクスペリエンスメトリクスインストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションを省略した場合(または
/disableexperiencemetricsが指定されている場合)、分析データはローカルで収集されますが、自動的には送信されません。 -
/テンプディル ディレクトリインストール中に一時ファイルを保持するディレクトリ。デフォルト =
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
スタンドアロン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
-
-
まずパッケージから既存のディレクトリにファイルを抽出し、その後インストールコマンドを実行するか、単にパッケージを実行します。ファイルをインストールする前に抽出するには、絶対パスを指定して
/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 をインストールするためのコマンドラインオプション
以下のオプションは、次のコマンド(インストーラー)のいずれか、または複数で有効です:
VDAServerSetup_xxxx.exe、VDAWorkstationSetup_xxxx.exe、および VDAWorkstationCoreSetup_xxxx.exe。
オプションの詳細については、「VDA のインストール」を参照してください。
-
/コンポーネント コンポーネント\[,コンポーネント\]インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
VDA: バーチャル デリバリー エージェント -
PLUGINS: Windows向けCitrix Workspace™アプリ
VDA と Citrix Workspace app for Windows をインストールするには、/components vda,pluginsを指定します。このオプションを省略すると、VDA のみがインストールされます(Citrix Workspace app はインストールされません)。このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合は無効です。そのインストーラーではCitrix Workspace appをインストールできません。 -
-
/controllers "コントローラー \[コントローラー\]"VDAが通信できるControllerのFQDNをスペースで区切り、引用符で囲みます。
/site_guidオプションと/controllersオプションの両方を指定しないでください。 -
/エクスペリエンスメトリクス無効化インストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
-
/enable\_hdx\_portsWindowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、VDAおよび有効な機能(Windowsリモートアシスタンスを除く)に必要なポートをWindowsファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、ネットワークポートを参照してください。HDX アダプティブトランスポートが使用する UDP ポートを開くには、この
/enable_hdx_portsオプションに加えて、/enable_hdx_udp_portsオプションを指定します。 -
/enable\_hdx\_udp\_portsWindows ファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、HDX アダプティブトランスポートが使用する Windows ファイアウォールの UDP ポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。VDAが使用する追加ポートを開くには、この
/enable_hdx_udp_portsオプションに加えて、/enable_hdx_portsオプションを指定します。 -
/enable_hdx_tls_dtlsHDX™ Direct V1用にTCPおよびUDPポート443を開きます。
-
/enable\_real\_time\_transportオーディオパケットにUDPを使用するかどうかを有効または無効にします(オーディオ用のRealTime Audio Transport)。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。Windowsファイアウォールサービスが検出されたときにUDPポートを自動的に開く場合は、
/enable_hdx_portsオプションを含めます。 -
/enable_remote_assistanceDirectorで使用するために、Windowsリモートアシスタンスのシャドウイング機能を有効にします。このオプションを指定すると、Windowsリモートアシスタンスはファイアウォール内の動的ポートを開きます。
-
/enablerestore または /enablerestorecleanup(シングルセッションVDAにのみ有効)VDAのインストールまたはアップグレードが失敗した場合に、復元ポイントへの自動復帰を有効にします。インストール/アップグレードが正常に完了した場合:
-
/enablerestorecleanupは、インストーラーに復元ポイントを削除するよう指示します。 -
/enablerestoreは、使用されなかった場合でも、インストーラーに復元ポイントを保持するよう指示します。
詳細については、インストールまたはアップグレードの失敗時の復元を参照してください。 -
-
/enable\_ss\_portsWindows ファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、画面共有に必要なポートをWindows ファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でファイアウォールを構成する必要があります。
-
/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 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 は Citrix Profile Management Service をインストールして実行することを推奨します。Citrix Profile Management Service を有効にする必要はありません。/excludeと/includeadditionalの両方を同じコンポーネント名で指定した場合、そのコンポーネントはインストールされません。このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。このインストーラーは、これらの項目の多くを自動的に除外します。 -
/h または /helpコマンドのヘルプを表示します。
-
/includeadditional "コンポーネント"\[,"コンポーネント"\]1つ以上のコンマ区切りのオプションコンポーネントのインストールを含めます。各コンポーネントはストレート引用符で囲みます。このオプションは、Remote PC Access展開を作成し、デフォルトで含まれていない他のコンポーネントをインストールする場合に役立ちます。有効な値は次のとおりです。
マルチセッション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。 -
/install_mcsio_driver使用しないでください。代わりに
/includeadditional "Citrix MCS IODriver"または/exclude "Citrix MCS IODriver"を使用してください。 -
/logpath パスログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト = 「
%TEMP%\Citrix\XenDesktop Installer」このオプションはグラフィカルインターフェイスでは利用できません。 -
マスターイメージVDAをVMにインストールする場合にのみ有効です。他のマシンを作成するために使用するイメージとしてVDAをセットアップします。このオプションは
/mastermcsimageと同等です。このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合には無効です。 -
マスターMCSイメージこのマシンがMachine Creation Servicesでイメージとして使用されることを指定します。このオプションは
/masterimageと同等です。 -
マスターPVSイメージこのマシンが、Citrix Provisioning™またはサードパーティのプロビジョニングツール(Microsoft System Center Configuration Managerなど)を使用してVMをプロビジョニングするためのイメージとして使用されることを指定します。
-
WebSocketトークン WebSocketTokenWeb Socket VDAを作成します。WebSocketTokenは、必要なトークン用です。
-
/no\_mediafoundation\_ackMicrosoft 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プロトコルを使用する予定があり、アウトバウンド接続用にネットワークに非透過型プロキシがある場合は、ここでプロキシを指定します。HTTPプロキシのみがサポートされています。Rendezvousプロトコルで使用するプロキシのアドレスまたはPACファイルのパスです。機能の詳細については、Rendezvousプロトコル を参照してください。
-
プロキシアドレスの形式:
http://<url-or-ip>:<port> -
PACファイルの形式:
http://<url-or-ip>:<port>/<path>/<filename>.pac
-
-
サイレント または パッシブインストール中にユーザーインターフェイスは表示されません。インストールおよび構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/再構成
/portnumber、/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成されたVDA設定をカスタマイズします。このオプションを/quietオプションと同時に指定しない場合、VDAをカスタマイズするためのグラフィカルインターフェイスが起動します。 -
/リモートPCRemote PC Access展開(シングルセッションOS)またはブローカー接続(マルチセッションOS)でのみ有効です。追加コンポーネントのインストールを除外します(
/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。/remotepcは/servervdiオプションと互換性がありません。 -
/削除
/componentsオプションで指定されたコンポーネントを削除します。 -
/remove_appdisk_ackインストールされている場合、VDAインストーラーがAppDisks™ VDAプラグインをアンインストールすることを承認します。
-
/remove_pvd_ackインストールされている場合、VDAインストーラーがPersonal vDiskをアンインストールすることを承認します。
-
/すべて削除VDAを削除します。Citrix Workspaceアプリ(インストールされている場合)は削除しません。
-
/エクスペリエンスメトリックを送信インストール、アップグレード、または削除中に収集された分析データを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にインストールする場合にのみ有効です。インストーラーによる物理マシンの検出を上書きします。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ファイアウォールルールを自動的に追加させるには自動を選択し、管理者がファイアウォールを手動で構成できるようにするには手動を選択します。
プリントサーバーにソフトウェアをインストールした後、「プリンターのプロビジョニング」のガイダンスを使用してUniversal Print Serverを構成します。
Secure Private Accessをインストールするためのコマンドラインオプション
以下のオプションは、以下のコマンド(インストーラー)で有効です:
XenDesktopSPASetup.exe
-
/enable_spa_portsWindowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、Secure Private Accessに必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。
-
/NoSQLSecure Private AccessをインストールするサーバーへのMicrosoft SQL Server Expressのインストールを防止します。このオプションを省略すると、サイトデータベースとしてSQL Server Expressがインストールされます。
-
/ヘルプ または /h または /?コマンドのヘルプを表示します
-
/再起動しないインストール後の再起動を防止します。Secure Private Access は再起動するまで使用できません。
-
/サイレント または /パッシブインストール中にユーザーインターフェイスは表示されません。インストールと構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/削除Secure Private Accessを削除します。
オプションの詳細については、「Secure Private Access インストーラー」を参照してください。
詳細情報
Citrix がコンポーネントインストールの結果を報告する方法については、「Citrix インストールリターンコード」を参照してください。