コマンドラインを使用したインストール
重要:
-
アップグレードする場合で、現在のバージョンが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データ要素 を参照してください。License Serverライセンスデータの詳細については、Citrix Licensing Data を参照してください。 -
-
インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
CONTROLLER: コントローラー -
DESKTOPSTUDIO: スタジオ -
WEBSTUDIO: ウェブスタジオ -
DESKTOPDIRECTOR: ディレクター -
LICENSESERVER: Citrix ライセンスサーバー -
SECUREPRIVATEACCESS: セキュアプライベートアクセス
このオプションを省略した場合、すべてのコンポーネントがインストールされます (/removeオプションも指定されている場合は、削除されます)。(2003年より前のリリースでは、有効な値にはSTOREFRONTが含まれていました。2003年以降のバージョンでは、Use the full-product installerに記載されている専用のStoreFrontインストールコマンドを使用してください)。 -
-
/onlyprereqs オプション選択したコンポーネントの前提条件のみがインストールされます。Citrix製品コンポーネントはインストールされません。
-
/configure_firewallWindows Firewallサービスが実行されている場合、ファイアウォールが有効になっていなくても、インストールされるコンポーネントが使用するWindowsファイアウォール内のすべてのポートを開きます。サードパーティ製ファイアウォールまたはファイアウォールを使用していない場合は、手動でポートを開く必要があります。
-
/disableexperiencemetrics オプションインストール、アップグレード、または削除中に収集された分析データがCitrixに自動的にアップロードされるのを防ぎます。
-
/help または /hコマンドのヘルプを表示します。
-
/ignore\_hw\_check\_failureハードウェアチェックが失敗した場合(例えば、RAM不足のため)でも、Delivery Controllerのインストールまたはアップグレードを続行できます。詳細については、ハードウェアチェックを参照してください。
-
/ignore\_site\_test\_failureControllerのアップグレード中にのみ有効です。通常、サイトテストの失敗は無視され、アップグレードは続行されます。省略された場合(または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オプションで指定されたコアコンポーネントを削除します。 -
/すべて削除インストールされているすべてのコアコンポーネントを削除します。
-
/SKIPHDXDRIVERCHECKVDAメタインストーラーへのHDX™ ドライバーのチェックをスキップします。
-
/エクスペリエンスメトリックを送信インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションを省略した場合(または
/disableexperiencemetricsが指定されている場合)、分析データはローカルで収集されますが、自動的には送信されません。 -
一時ディレクトリ directoryインストール中に一時ファイルを保持するディレクトリ。デフォルト =
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コアサービス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 をインストールするためのコマンドラインオプション
以下のオプションは、次の1つ以上のコマンド(インストーラー)で有効です:
VDAServerSetup_xxxx.exe、VDAWorkstationSetup_xxxx.exe、およびVDAWorkstationCoreSetup_xxxx.exe。
オプションの詳細については、「VDA のインストール」を参照してください。
-
/コンポーネント コンポーネント\[,コンポーネント\]インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
-
VDA: バーチャル デリバリー エージェント -
PLUGINS: Citrix Workspace™ アプリ (Windows用)
VDAとCitrix Workspaceアプリ for Windowsをインストールするには、/components vda,pluginsを指定するか、コンポーネントをまったく指定しないでください。コンポーネントが指定されていない場合、デフォルトではVDAのみがインストールされます。VDA のみをインストールし、Citrix Workspace アプリのインストールを除外するには、/components vdaを指定します。このオプションは、VDAWorkstationCoreSetup_xxxx.exeインストーラーを使用する場合は無効です。そのインストーラーでは Citrix Workspace app をインストールできません。 -
-
前提条件のみ選択したコンポーネントの前提条件のみがインストールされます。Citrix 製品コンポーネントはインストールされません。
-
コントローラー "controller \[controller\]"VDA が通信できるコントローラーのスペース区切りの 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_SECURE_DEFAULTSより安全な初期設定のために、さまざまな機能のデフォルト設定を有効から無効に変更します。関連する機能は、クライアントドライブリダイレクト、特殊フォルダーリダイレクト、ドラッグアンドドロップ、クライアントTWAINデバイスリダイレクト、クライアントUSBプラグアンドプレイデバイスリダイレクト、クライアントプリンターリダイレクト、クライアントクリップボードリダイレクト、およびクライアントマイクリダイレクトです。
-
/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 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。 -
/install_mcsio_driver使用しないでください。代わりに、
/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 WebSocketトークンWeb Socket VDAを作成します。WebSocketTokenは、必要なトークン用です。
-
/websockettokenfile WebSockトークンを含むファイルWeb Socket VDAを作成します。FileContainingWebSockToken は、必要なトークンを含むファイル用です。
-
ウェブソケットトークン標準入力 <ウェブソケットトークン>Web Socket VDAを作成します。<WebSocketToken は、STDINによって渡される必要なトークン用です。
-
/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レジストリキーをチェックして、値が存在し、空ではないことを確認してください。 -
/nodesktopexperience (デスクトップエクスペリエンスなし)拡張デスクトップエクスペリエンス機能は利用できなくなりました。このオプション(およびポリシー設定)は、指定されても無視されます。マルチセッションOS用VDAのインストール時にのみ有効です。拡張デスクトップエクスペリエンス機能の有効化を防止します。この機能は、拡張デスクトップエクスペリエンスCitrixポリシー設定でも制御されます。
-
/noreboot (再起動なし)インストール後の再起動を防止します。VDAは再起動するまで使用できません。
-
/noresume (再開なし)デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、
/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。 -
物理マシンRemotePC インストールの場合、この引数を
/remotepcとともに使用します。そうしないと、特定のユーザーシナリオで VDA が予期したとおりに動作しない可能性があります。 -
/ポート番号 ポート
/reconfigオプションが指定されている場合にのみ有効です。VDAとController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。 -
/プロキシ構成 “アドレスまたはPACファイルのパス”環境で Gateway Service などのサービスと Rendezvous プロトコルを使用する予定があり、ネットワークにアウトバウンド接続用の非透過型プロキシがある場合は、ここでプロキシを指定します。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
-
-
/サイレント または /パッシブインストール中にユーザーインターフェイスは表示されません。インストールと構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
-
/再構成
/portnumber、/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成されたVDA設定をカスタマイズします。このオプションを/quietオプションも指定せずに指定すると、VDAをカスタマイズするためのグラフィカルインターフェイスが起動します。 -
/リモートPCRemote PC Access 展開 (シングルセッション OS) または仲介接続 (マルチセッション OS) の場合にのみ有効です。追加コンポーネントのインストールは除外されます (
/excludeおよび/includeadditionalオプションのコンポーネントリストを参照)。このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。/remotepcは/servervdiオプションと互換性がありません。 -
/削除
/componentsオプションで指定されたコンポーネントを削除します。 -
/remove_appdisk_ackAppDisks™ VDAプラグインがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
-
/remove_pvd_ackPersonal vDiskがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
-
/すべて削除VDAを削除します。Citrix Workspaceアプリ(インストールされている場合)は削除しません。
-
/REMOVEALLWITHCWAVDA とともに CWA を削除します。
-
/エクスペリエンスメトリックを送信インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合(または
/disableexperiencemetricsオプションが指定された場合)、分析データはローカルで収集されますが、自動的には送信されません。 -
/サーバーVDIサポートされているWindowsマルチセッションマシンにシングルセッションOS用VDAをインストールします。WindowsマルチセッションマシンにマルチセッションOS用VDAをインストールする場合は、このオプションを省略してください。このオプションを使用する前に、サーバーVDI を参照してください。このオプションは、フルプロダクトVDAインストーラーでのみ使用してください。
-
/site\_guid グイッドサイトのActive Directory組織単位 (OU) のグローバル一意識別子。これは、Active Directoryを検出に使用している場合に、仮想デスクトップをサイトに関連付けます(自動更新が推奨されるデフォルトの検出方法です)。サイトGUIDは、Studioに表示されるサイトプロパティです。
/site_guidオプションと/controllersオプションの両方を指定しないでください。 -
一時ディレクトリ directoryインストール中に一時ファイルを保持するディレクトリ。デフォルト =
c:\Windows\Temp。このオプションはグラフィカルインターフェイスでは利用できません。 -
仮想マシンVMにVDAをインストールする場合にのみ有効です。インストーラーによる物理マシンの検出を上書きします。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ファイアウォールルールを自動的に追加させるには「自動」を選択するか、管理者がファイアウォールを手動で構成できるように「手動」を選択します。
印刷サーバーにソフトウェアをインストールした後、(/ja-jp/citrix-virtual-apps-desktops/2407/printing/printing-provision-printers.html)のガイダンスを使用してUniversal Print Serverを構成します。
Secure Private Accessをインストールするためのコマンドラインオプション
以下のオプションは、両方で有効です。
-
CVADインストーラー:
XenDesktopSPASetup.exe -
SPAオンプレミスインストーラー:
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_portsWindowsファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、Secure Private Accessに必要なWindowsファイアウォールのポートを開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、「ネットワークポート」を参照してください。
-
ノーSQLSecure 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 installerを参照してください。
詳細情報
Citrixがコンポーネントインストールの結果を報告する方法については、Citrix installation return codesを参照してください。