インストール準備
Citrix Virtual Apps and Desktops™ の展開は、次のコンポーネントのインストールから始まります。このプロセスにより、ファイアウォール内のユーザーにアプリケーションとデスクトップを配信する準備が整います。
- 1つ以上のデリバリーコントローラー
- シトリックス ディレクター
- シトリックス ストアフロント™
- シトリックス ライセンスサーバー
- 1つ以上のCitrix 仮想配信エージェント (VDA)
- 汎用印刷サーバー、フェデレーション認証サービス、セルフサービスパスワードリセットなどのオプションのコンポーネントとテクノロジー
ファイアウォールの外部のユーザー向けには、Citrix Gatewayなどの追加コンポーネントをインストールして構成します。概要については、「Citrix Virtual Apps and DesktopsとCitrix Gatewayの統合」を参照してください。
注：
サーバーOSおよびワークステーションOSで、次のMicrosoftの前提条件が満たされていることを確認してください。
- Microsoft ボリュームシャドウコピー および Microsoft Software Shadow Copy プロバイダー サービスが実行されています。詳細については、Volume Shadow Copy Service を参照してください。
- MS-Defender のバージョンは 4.18.2105.5 より高い必要があります。詳細については、Microsoft Defender ウイルス対策のセキュリティインテリジェンスと製品の更新 を参照してください。
展開にWindows Serverワークロードが含まれている場合は、Microsoft RDSライセンスサーバーを構成します。
製品ISOのフルプロダクトインストーラーを使用して、多くのコンポーネントとテクノロジーを展開できます。スタンドアロンVDAインストーラーを使用してVDAをインストールできます。スタンドアロンVDAインストーラーは、Citrixダウンロードサイトで入手できます。すべてのインストーラーは、グラフィカルインターフェイスとコマンドラインインターフェイスを提供します。「インストーラー」を参照してください。
製品ISOには、Active Directory内のマシンにVDAをインストール、アップグレード、または削除するサンプルスクリプトが含まれています。これらのスクリプトは、Machine Creation Services (MCS) およびCitrix Provisioning (旧Provisioning Services) で使用されるイメージの管理にも使用できます。詳細については、「スクリプトを使用したVDAのインストール」を参照してください。
インストール前に確認する情報
- 技術概要: 製品とそのコンポーネントに慣れるため。
- セキュリティ: 展開環境を計画する際。
- 既知の問題: このバージョンで発生する可能性のある問題。
- データベース: システムデータベースとその構成方法について学習します。Controllerのインストール中に、サイトデータベースとして使用するSQL Server Expressをインストールできます。ほとんどのデータベース情報は、コアコンポーネントのインストール後にサイトを作成するときに構成します。
- Remote PC Access: ユーザーがオフィスにある物理マシンにリモートでアクセスできるようにする環境を展開する場合。
- 接続とリソース: アプリケーションとデスクトップ用のVMをホストまたはプロビジョニングするためにハイパーバイザーまたはその他のサービスを使用している場合。最初の接続は、サイトを作成するとき（コアコンポーネントのインストール後）に構成できます。それまでに仮想化環境をセットアップしてください。
- Microsoft System Center Configuration Manager: ConfigMgr を使用してアプリケーションとデスクトップへのアクセスを管理している場合、またはリモートPCアクセスでウェイクオンLAN機能を使用している場合。
- パブリッククラウドホスト接続: ハイブリッド権限ライセンスをお持ちの場合、パブリッククラウドへのホスト接続を作成できます。ハイブリッド権限ライセンスに関する情報については、「Hybrid Rights Renewals」を参照してください。パブリッククラウドの資格とこの変更の理由に関する情報については、「CTX270373」を参照してください。
コンポーネントのインストール場所
サポートされているプラットフォーム、オペレーティングシステム、およびバージョンについては、「システム要件」を確認してください。コンポーネントの前提条件は、特に記載がない限り自動的にインストールされます。Citrix StoreFrontおよびCitrix License Serverのドキュメントで、サポートされているプラットフォームと前提条件を確認してください。
コアコンポーネントは、同じサーバーまたは異なるサーバーにインストールできます。
- すべてのコアコンポーネントを1つのサーバーにインストールする方法は、評価、テスト、または小規模な本番展開で機能します。
- 将来の拡張に対応するために、コンポーネントを異なるサーバーにインストールすることを検討してください。たとえば、Controllerをインストールしたサーバーとは別のマシンにStudioをインストールすると、サイトをリモートで管理できます。
-
ほとんどの運用環境では、コアコンポーネントを個別のサーバーにインストールすることをお勧めします。
他のサーバーに他のコンポーネントをインストールする前に、Citrix License Serverとライセンスをインストールしてください。
- Server CoreOS (Delivery Controllerなど) にサポートされているコンポーネントをインストールするには、(/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/install-command.html)を使用する必要があります。このOSタイプにはグラフィカルインターフェイスがないため、Studioやその他のツールは別の場所にインストールし、それらをControllerサーバーにポイントしてください。
Delivery Controller™とマルチセッションOS用VDAの両方を同じサーバーにインストールできます。インストーラーを起動し、Delivery Controller (およびそのマシンにインストールしたい他のコアコンポーネント) を選択します。その後、インストーラーを再度起動し、マルチセッションOS用のVirtual Delivery Agentを選択します。
各オペレーティングシステムが最新のアップデートであることを確認してください。
すべてのマシンのシステムクロックが同期されていることを確認してください。マシン間の通信を保護するKerberosインフラストラクチャには同期が必要です。
XenServerを使用している場合、仮想マシンの電源状態が登録済みと表示されていても、不明と表示されることがあります。この問題を解決するには、ホストとの時刻同期を無効にするために、レジストリキーHostTimeの値を編集します。
HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"
ヒント:
デフォルト値は
HostTime="UTC"です。この値をUTC以外のもの、たとえばLocalに変更してください。この変更により、ホストとの時刻同期が実質的に無効になります。
Windows 10シングルセッションマシンの最適化ガイダンスは、CTX216252で入手できます。
コンポーネントをインストールしてはならない場所:
- Active Directoryドメインコントローラーには、いかなるコンポーネントもインストールしないでください。
- SQL Serverクラスタリングインストール、SQL Serverミラーリングインストール、またはHyper-Vを実行しているサーバーのノードにControllerをインストールすることはサポートされていません。
この製品バージョンがサポートしていないWindows OSにVDAをインストールまたはアップグレードしようとすると、オプションを説明する記事に誘導するメッセージが表示されます。
権限とアクティブディレクトリの要件
コンポーネントをインストールするマシンでは、ドメインユーザーであり、ローカル管理者である必要があります。
スタンドアロンVDAインストーラーを使用するには、管理者権限を昇格させるか、管理者として実行を使用する必要があります。
インストールを開始する前に、Active Directoryドメインを構成してください。
- システム要件には、サポートされているActive Directoryの機能レベルが記載されています。Active Directoryに参加済みには、詳細情報が含まれています。
- Active Directoryドメインサービスを実行しているドメインコントローラーが少なくとも1つ必要です。
- ドメインコントローラーにCitrix Virtual Apps™ and Desktopsコンポーネントをインストールしないでください。
- Studioで組織単位名を指定する際に、スラッシュ（/）を使用しないでください。
Citrix License Serverのインストールに使用されるWindowsユーザーアカウントは、委任管理のフル管理者として自動的に構成されます。
詳細については、以下を参照してください。
- セキュリティのベストプラクティス
- 委任管理
- マイクロソフトのアクティブディレクトリ構成に関するドキュメント
インストールのガイダンス、考慮事項、およびベストプラクティス
任意のコンポーネントのインストール中
-
フルプロダクトメディアからDelivery Controller、Studio、License Server、またはDirectorをインストールまたはアップグレードする際に、Citrixインストーラーがマシン上の以前のWindowsインストールからの再起動が保留中であることを検出すると、インストーラーは終了/リターンコード9で停止します。マシンの再起動を求められます。
これはCitrixによって強制される再起動ではありません。以前にマシンにインストールされた他のコンポーネントが原因です。この状況が発生した場合は、マシンを再起動してからCitrixインストーラーを再度起動してください。
コマンドラインインターフェイスを使用する場合、コマンドに
/no_pending_reboot_checkオプションを含めることで、保留中の再起動のチェックを回避できます。 -
通常、コンポーネントに前提条件がある場合、インストーラーはそれらが存在しない場合に展開します。一部の前提条件では、マシンの再起動が必要になる場合があります。
-
インストール前、インストール中、インストール後にオブジェクトを作成する際は、各オブジェクトに一意の名前を指定してください。たとえば、ネットワーク、グループ、カタログ、リソースには一意の名前を付けてください。
-
コンポーネントが正常にインストールされない場合、インストールはエラーメッセージとともに停止します。正常にインストールされたコンポーネントは保持されます。それらを再インストールする必要はありません。
-
コンポーネントをインストール（またはアップグレード）すると、Citrix Analyticsが自動的に収集されます。デフォルトでは、インストールが完了するとそのデータは自動的にCitrixにアップロードされます。また、コンポーネントをインストールすると、匿名データをアップロードするCitrix Customer Experience Improvement Program (CEIP) に自動的に登録されます。
インストール中に、メンテナンスとトラブルシューティングのために診断情報を収集する他のCitrixテクノロジーに参加することも選択できます。これらのプログラムの詳細については、Citrix Insight Services を参照してください。
-
Studioをインストール（またはアップグレード）すると、Google Analyticsが自動的に収集され（その後アップロードされます）。Studioのインストール後、レジストリキー
HKLM\Software\Citrix\DesktopStudio\GAEnabledを使用してこの設定を変更できます。値が 1 の場合、収集とアップロードが有効になり、0 の場合、収集とアップロードが無効になります。 -
VDAのインストールが失敗した場合、MSIアナライザーは失敗したMSIログを解析し、正確なエラーコードを表示します。既知の問題である場合、アナライザーはCTX記事を提案します。アナライザーはまた、失敗エラーコードに関する匿名化されたデータを収集します。このデータは、CEIPによって収集された他のデータとともに含まれます。CEIPへの登録を終了すると、収集されたMSIアナライザーデータはCitrixに送信されなくなります。
VDAのインストール中
-
Citrix Workspace™ app for Windowsは利用可能ですが、VDAをインストールする際にはデフォルトではインストールされません。ユーザーまたはご自身で、CitrixウェブサイトからCitrix Workspace app for Windowsおよびその他のCitrix Workspaceアプリをダウンロードしてインストール（およびアップグレード）できます。または、それらのCitrix WorkspaceアプリをStoreFrontサーバーから利用可能にすることもできます。StoreFrontのドキュメントを参照してください。
-
Microsoft Print Spoolerサービスは有効にする必要があります。このサービスが無効になっている場合、VDAを正常にインストールすることはできません。
-
ほとんどのサポートされているWindowsエディションには、Microsoft Media Foundationがすでにインストールされています。マシンにMedia Foundationがない場合（Nエディションなど）、いくつかのマルチメディア機能はインストールされず、動作しません。
- ウィンドウズメディアリダイレクト
- HTML5ビデオのリダイレクト
- HDX™ リアルタイム ウェブカメラ リダイレクト
制限を承諾するか、Media Foundationのインストール後にVDAのインストールを終了して後で再開することができます。グラフィカルインターフェイスでは、この選択肢はメッセージで表示されます。コマンドラインでは、
/no_mediafoundation_ackオプションを使用して制限を承諾できます。 -
VDAをインストールすると、Direct Access Usersという新しいローカルユーザーグループが自動的に作成されます。シングルセッションOS用VDAでは、このグループはRDP接続にのみ適用されます。マルチセッションOS用VDAでは、このグループはICA®およびRDP接続に適用されます。
-
VDAは、通信するための有効なControllerアドレスを持っている必要があります。そうしないと、セッションを確立できません。Controllerアドレスは、VDAのインストール時または後で指定できます。必ず実行してください。詳細については、VDA登録を参照してください。
VDAインストール後およびインストール中の再起動
VDAインストールの終了時に再起動が必要です。その再起動は、デフォルトで自動的に行われます。
VDAをバージョン7.17（またはそれ以降のサポートされているバージョン）にアップグレードする場合、アップグレード中に再起動が発生します。これは回避できません。
VDAインストール中に必要な再起動の回数を最小限に抑えるには:
- VDAのインストールを開始する前に、サポートされている.NET Frameworkバージョンがインストールされていることを確認してください。
- WindowsマルチセッションOSマシンでは、VDAをインストールする前にRDSロールサービスをインストールして有効にしてください。
VDAをインストールする前にこれらの前提条件をインストールしない場合:
- グラフィカルインターフェイスまたは
/norebootオプションなしでコマンドラインインターフェイスを使用している場合、前提条件のインストール後にマシンが自動的に再起動します。 -
/norebootオプションを使用してコマンドラインインターフェイスを使用している場合、再起動を開始する必要があります。
VDAバージョンをアップグレードする際、アップグレード中に再起動が発生します。これは避けられません。
インストールまたはアップグレード失敗時の復元
注：
この機能は、シングルセッションおよびマルチセッションVDAで利用できます。
シングルセッションVDAのインストールまたはアップグレードが失敗し、「失敗時の復元」機能が有効になっている場合、マシンはインストールまたはアップグレードが開始される前に設定された復元ポイントに戻されます。
マルチセッションVDAのインストールまたはアップグレードが失敗し、「失敗時の復元」機能が有効になっている場合、マシンはインストールまたはアップグレードが開始される前に実行されたバックアップに戻されます。
この機能を有効にしてシングルセッションVDAのインストールまたはアップグレードを開始すると、インストーラーは実際のインストールまたはアップグレードを開始する前にシステム復元ポイントを作成します。VDAのインストールまたはアップグレードが失敗した場合、マシンは復元ポイントの状態に戻されます。%temp%/Citrixフォルダーには、展開ログと復元に関するその他の情報が含まれています。
この機能を有効にしてマルチセッションVDAのインストールまたはアップグレードを開始すると、インストーラーは実際のインストールまたはアップグレードを開始する前にサーバーバックアップを作成します。VDAのインストールまたはアップグレードが失敗した場合、マシンはバックアップの状態に戻されます。%temp%/Citrixフォルダーには、展開ログと復元に関するその他の情報が含まれています。サーバーバックアップの作成にかかる時間は、必要なバックアップのサイズとサーバーで利用可能なリソースの量に基づきます。バックアップは C:\WindowsImageBackup\servername に保存されます。
この機能は、デフォルトで無効になっています。
この機能を有効にする予定がある場合は、GPO設定（Computer Configuration > Administrative Templates > System > System Restore）によってシステム復元が無効になっていないことを確認してください。
注：
このGPO設定は、マルチセッションVDAの復元には適用されません。
シングルセッションまたはマルチセッションVDAをインストールまたはアップグレードする際にこの機能を有効にするには：
-
VDAインストーラーのグラフィカルインターフェイス（Autostartの使用や、復元またはサイレントオプションなしで
XenDesktopVDASetup.exeコマンドを使用する場合など）を使用する場合は、SummaryページでEnable automatic restore if update failsチェックボックスを選択します。インストール/アップグレードが正常に完了した場合、復元ポイント/バックアップは使用されませんが、保持されます。
-
コマンドラインを使用して、
/enablerestoreまたは/enablerestorecleanupオプションのいずれかでVDAインストーラーを実行します。-
/enablerestorecleanupオプションを使用し、インストール/アップグレードが正常に完了した場合、復元ポイント/サーバーバックアップは自動的に削除されます。 -
/enablerestoreオプションを使用し、インストール/アップグレードが正常に完了した場合、復元ポイントは使用されませんが、保持されます。
-
インストーラー
フルプロダクトインストーラー
ISOで提供されているフルプロダクトインストーラーを使用すると、次のことができます。
- コアコンポーネント（Delivery Controller、Studio、Director、およびLicense Server）をインストール、アップグレード、または削除します。
- StoreFrontをインストールまたはアップグレードします。
- シングルセッションまたはマルチセッションオペレーティングシステム用のWindows VDAをインストールまたはアップグレードします。
- プリンターサーバーにUniversal Print Server
UpsServerコンポーネントをインストールします。 - フェデレーション認証サービスをインストールします。
- セッションレコーディングをインストールします。
-
ワークスペース環境管理をインストールします。
注：
Workspace Environment Management™ Agentインストーラーはローカライズされていません。英語でのみ利用可能です。
1人のユーザー（Web開発など）にマルチセッションOSからデスクトップを提供するには、フルプロダクトインストーラーのコマンドラインインターフェイスを使用します。詳細については、「Server VDI」を参照してください。
スタンドアロンVDAインストーラー
スタンドアロンVDAインストーラーは、Citrixダウンロードページで入手できます。（製品インストールメディアからは入手できません。）スタンドアロンVDAインストーラーは、フルプロダクトISOよりもはるかに小さく、次のような展開に容易に対応できます。
- ステージングまたはローカルにコピーされた電子ソフトウェア配布（ESD）パッケージを使用する
- 物理マシンを使用する
- リモートオフィスがある
デフォルトでは、自己解凍型スタンドアロンVDAのファイルはTempフォルダーに抽出されます。Tempフォルダーに抽出する場合、フルプロダクトインストーラーを使用する場合よりも、マシンにより多くのディスク容量が必要です。ただし、Tempフォルダーに抽出されたファイルは、インストール完了後に自動的に削除されます。または、絶対パスを指定して/extractコマンドを使用することもできます。
4つのスタンドアロンVDAインストーラーをダウンロードできます。
マルチセッションOS 仮想デリバリーエージェント (VDAServerSetup.exe):
マルチセッションOS用のVDAをインストールします。フルプロダクトインストーラーで利用可能なマルチセッションOS用VDAのすべてのオプションをサポートします。
シングルセッションOS向け仮想配信エージェント (VDAWorkstationSetup.exe):
シングルセッションOS用のVDAをインストールします。フルプロダクトインストーラーで利用可能なシングルセッションOS用VDAのすべてのオプションをサポートします。
シングルセッションOSコアサービス向け仮想配信エージェント (VDAWorkstationCoreSetup.exe):
Remote PC Access展開またはコアVDIインストール用に最適化されたシングルセッションOS用のVDAをインストールします。Remote PC Accessは物理マシンを使用します。コアVDIインストールは、イメージとして使用されていないVMです。このような展開のVDA接続に必要なコアサービスのみをインストールします。そのため、フルプロダクトインストーラーまたはVDAWorkstationSetup.exeインストーラーで有効なオプションのサブセットのみをサポートします。
このインストーラーは、次の目的で使用されるコンポーネントをインストールまたは含みません。
- アップブイ。
- プロファイル管理。Citrix Profile Managementをインストールから除外すると、Citrix Directorの表示に影響します。詳細については、「VDAのインストール」を参照してください。
- マシンIDサービス。
- シトリックス エムシーエス アイオードライバー
- Citrixバックアップおよび復元
- デバイス トラスト
- ウーバーエージェント
- WEM
VDAWorkstationCoreSetup.exe インストーラーは、以下のコンポーネントをインストールせず、また含んでいません：Windows向けCitrix Workspaceアプリ (CWA)、Citrix Secure Accessクライアント (CSA)、Citrixユーザーパーソナライゼーションレイヤー (UPL)、セッションレコーディングエージェント (SRAGENT)、およびCitrix Assistantアプリ (ASSISTANTAPP)。
VDAWorkstationCoreSetup.exeを使用することは、フルプロダクトまたはVDAWorkstationSetupインストーラーを使用してシングルセッションOS VDAをインストールすることと等価であり、以下のいずれかに該当します。
- グラフィカルインターフェイスで: 環境ページでRemote PC Accessオプションを選択する。
- コマンドラインインターフェイスで:
/remotepcオプションを指定する。 - コマンドラインインターフェイスで:
/components vdaと、有効な追加コンポーネント名をすべてリストする/excludeオプションを指定する。
省略されたコンポーネント/機能は、後でフルプロダクトインストーラーを実行することでインストールできます。この操作により、不足しているすべてのコンポーネントをインストールできます。
VDAWorkstationCoreSetup.exeインストーラーは、Browser Content Redirection MSIを自動的にインストールします。この自動インストールは、VDAリリース2003以降のサポートされているリリースに適用されます。
シングルセッション コアサービス バーチャル デリバリー エージェント (VDASingleSessionCoreSetup.exe):
Windows 365 Cloud PC および Remote PC の展開で利用できる、新しい軽量のシングルセッション VDA メタインストーラーです。このインストーラーは、既存の VDAWorkstationCoreSetup.exe インストーラーをベースに構築されており、Profile Management、deviceTRUST、uberAgent、WEM、Backup and Restore、および VDA Upgrade Agent とともに、不可欠な VDA コンポーネントを提供します。Backup and Restore 機能は、コマンドラインオプション /enablerestore または /enablerestorecleanup を使用して有効にできます。
これにより、パッケージサイズが大幅に削減され、クラウドベースのワークロードのインストール信頼性が向上します。最新の Remote PC シナリオ向けに設計されたこのインストーラーは、Windows 365 および Remote PC に Citrix ワークロードを展開するための、シンプルで高性能なオプションを提供します。
シングルセッション VDA インストーラーを使用するためのベストプラクティス
シングルセッションオペレーティングシステムには、4 種類のインストーラーが用意されています。フルプロダクト VDA インストーラーと VDAWorkstationSetup.exe インストーラーはすべてのコンポーネントのインストールを提供しますが、VDAWorkstationCoreSetup.exe および VDASingleSessionCoreSetup.exe インストーラーには、一部のデフォルトコンポーネントと追加コンポーネントは含まれていません。
環境の安定性、一貫したパフォーマンス、および継続的なサポート性を維持するために、Citrix は、Citrix VDA のライフサイクル全体（インストール、アップグレード、アンインストールを含む）で一貫したインストーラータイプを使用することを推奨しています。インストーラータイプを混在させると、特定のリスクが生じる可能性があります。
インストーラータイプの混在に関連するリスク:
シナリオ 1: シングルセッション VDA が VDAWorkstationCoreSetup.exe または VDASingleSessionCoreSetup.exe インストーラーを使用して最初にインストールされ、その後フルプロダクト VDA インストーラーまたは VDAWorkstationSetup.exe インストーラーのいずれかでアップグレードされた場合、以前に除外されていたコンポーネントは、明示的に除外されない限り、アップグレード中にインストールされる可能性があります。
シナリオ 2: シングルセッション VDA がフルプロダクト VDA インストーラーまたは VDAWorkstationSetup.exe を使用して最初にインストールされ、その後 VDAWorkstationCoreSetup.exe または VDASingleSessionCoreSetup.exe を使用してアップグレードされた場合、コアサービス VDA インストーラーによってインストールされなかったコンポーネントはアップグレードから除外されます。これらのコンポーネントは、アップグレードプロセス中にアップグレードされることも、アンインストール中に削除されることもありません。
シナリオ 3: シングルセッション VDA が VDAWorkstationCoreSetup.exe インストーラーを使用して最初にインストールされ、その後 VDASingleSessionCoreSetup.exe でアップグレードされた場合、新しい機能が利用可能になります。次回 VDAWorkstationCoreSetup.exe でアップグレードした場合、VDASingleSessionCoreSetup.exe によって新しく追加されたコンポーネントは、アップグレードプロセス中にアップグレードされることも、アンインストール中に削除されることもありません。
インストーラータイプの混在に対処するためのガイダンス:
インストーラータイプを混在させる必要が生じた場合は、アップグレードプロセス中に同じコンポーネントが含まれるようにすることが不可欠です。
インストーラータイプが誤って混在し、追加のコンポーネントがインストールされたり、特定のコンポーネントが管理対象外になったりした場合で、以前の環境を復元する必要がある場合は、次のように進めてください。
-
シナリオ 1 の場合: プログラムのアンインストールまたは変更のための Windows 機能から VDA をアンインストールし、その後、最初に利用したインストーラー (VDAWorkstationCoreSetup.exe または VDASingleSessionCoreSetup.exe) を使用して VDA を再インストールします。
-
シナリオ 2 の場合: フルプロダクト VDA インストーラーまたは VDAWorkstationSetup.exe インストーラーを利用して、不足しているコンポーネントをアップグレードします。
-
シナリオ3の場合： 新機能の活用を継続する予定がある場合は、VDASingleSessionCoreSetup.exeインストーラーを使用して不足しているコンポーネントをアップグレードしてください。あるいは、VDASingleSessionCoreSetup.exeでアップグレードした後に新機能を使用しない場合は、まずWindowsのプログラムのアンインストールまたは変更機能からVDAをアンインストールし、その後VDAWorkstationCoreSetup.exeを使用してVDAを再インストールしてください。
Citrixインストールのリターンコード
インストールログには、コンポーネントインストールの結果がMicrosoftの値ではなくCitrixのリターンコードとして含まれています。
- 0 = 成功
- 1 = 失敗
- 2 = 部分的な成功
- 3 = 部分的な成功と再起動が必要
- 4 = 失敗と再起動が必要
- 5 = ユーザーによってキャンセルされました
- 6 = 不正なコマンドライン引数
- 7 = 新しいバージョンが見つかりました
- 8 = 成功、再起動が必要
- 9 = ファイルロックによる再起動
- 10 = 中止
- 11 = メディアの失敗
- 12 = ライセンス失敗
- 13 = 事前チェック失敗
- 14 = 再起動保留中チェック中止
- 15 = 事前チェック合格 - これは、新しい /precheckonly コマンドラインオプションを使用した後に事前チェックが合格した場合に返されます。
- 16 = 事前チェック不合格 - これは、新しい /precheckonly コマンドラインオプションを使用した後に事前チェックが不合格だった場合に返されます。
- 17 = オプションソフトウェア失敗 - これは、新しいオプションソフトウェアコンポーネントのいずれかのインストールに失敗し、「他の選択されたコンポーネントのいずれかが失敗した場合でもVDAのインストールまたはアップグレードを続行する」が選択されている場合に返されます。
例えば、Microsoft System Center Configuration Managerなどのツールを使用している場合、インストールログにリターンコード3が含まれていると、スクリプトによるVDAインストールが失敗したように見えることがあります。これは、VDAインストーラーが、ユーザーが開始する必要のある再起動（例えば、サーバーへのRDSロールの前提条件インストール後など）を待機している場合に発生する可能性があります。VDAのインストールは、すべての前提条件と選択されたコンポーネントがインストールされ、インストール後にマシンが再起動された場合にのみ成功と見なされます。
あるいは、インストールをCMDスクリプト（Microsoftの終了コードを返します）でラップするか、Configuration Managerパッケージの成功コードを変更することもできます。
Windows Serverワークロード用のMicrosoft RDSライセンスサーバーを構成する
この製品は、Windows 2016などのWindows Serverワークロードを提供するときに、Windows Serverのリモートセッション機能にアクセスします。これには通常、リモートデスクトップサービス クライアントアクセスライセンス (RDS CAL) が必要です。VDAは、RDS CALを要求するためにRDSライセンスサーバーに接続できる必要があります。ライセンスサーバーをインストールしてアクティブ化します。詳細については、Microsoftドキュメント「リモートデスクトップサービスライセンスサーバーをアクティブ化する」を参照してください。概念実証環境では、Microsoftが提供する猶予期間を使用できます。
この方法を使用すると、このサービスにライセンスサーバー設定を適用させることができます。イメージ上のRDSコンソールで、ライセンスサーバーとユーザーごとのモードを構成できます。Microsoftグループポリシー設定を使用してライセンスサーバーを構成することもできます。詳細については、Microsoftドキュメント「クライアントアクセスライセンス (CAL) を使用してRDS展開をライセンスする」を参照してください。
グループポリシー設定を使用してRDSライセンスサーバーを構成するには：
- 利用可能なマシンにリモートデスクトップサービスライセンスサーバーをインストールします。そのマシンは常に利用可能である必要があります。Citrix製品のワークロードは、このライセンスサーバーに到達できる必要があります。
- Microsoftグループポリシーを使用して、ライセンスサーバーアドレスとユーザーごとのライセンスモードを指定します。詳細については、Microsoftドキュメント「RDセッションホストサーバーのリモートデスクトップライセンスモードを指定する」を参照してください。
Windows 10ワークロードには、適切なWindows 10ライセンスのアクティベーションが必要です。Windows 10ワークロードをアクティブ化するには、Microsoftのドキュメントに従うことをお勧めします。
詳細情報
特定のホストタイプのリソースロケーションを設定するには：