インストールを準備する

最終公開日 : Nov 13, 2026
Citrix Virtual Apps and Desktops™ の展開は、次のコンポーネントのインストールから始まります。このプロセスにより、ファイアウォール内のユーザーにアプリケーションとデスクトップを配信する準備が整います。
  • 1つ以上のDelivery Controller
  • Citrix ディレクター
  • シトリックス ストアフロント™
  • シトリックス ライセンスサーバー
  • 1つ以上のシトリックス バーチャル デリバリー エージェント (VDA)
  • Universal Print Server、フェデレーション認証サービス、セルフサービスパスワードリセットなどのオプションコンポーネントとテクノロジー
ファイアウォール外部のユーザー向けには、Citrix Gatewayなどの追加コンポーネントをインストールして構成します。概要については、「Citrix Virtual Apps and DesktopsとCitrix Gatewayの統合」を参照してください。
注:
サーバーOSおよびワークステーションOSで、次のMicrosoftの前提条件が満たされていることを確認してください。
展開にWindows Serverワークロードが含まれる場合は、「Microsoft RDSライセンスサーバーの構成」を参照してください。
製品ISOに含まれるフル製品インストーラーを使用して、多くのコンポーネントとテクノロジーを展開できます。スタンドアロンVDAインストーラーを使用してVDAをインストールできます。スタンドアロンVDAインストーラーは、Citrixダウンロードサイトで入手できます。すべてのインストーラーには、グラフィカルインターフェイスとコマンドラインインターフェイスが用意されています。「インストーラー」を参照してください。
製品ISOには、Active Directory内のマシンにVDAをインストール、アップグレード、または削除するサンプルスクリプトが含まれています。これらのスクリプトを使用して、Machine Creation Services (MCS) およびCitrix Provisioning (旧Provisioning Services) で使用されるイメージを管理することもできます。詳しくは、「スクリプトを使用したVDAのインストール」を参照してください。

インストール前に確認する情報

  • Technical overview: 製品とそのコンポーネントに慣れるために。
  • Security: 展開環境を計画する際に。
  • Known issues: このバージョンで発生する可能性のある問題。
  • Databases: システムデータベースとその構成方法について学習します。Controllerのインストール中に、サイトデータベースとして使用するためにSQL Server Expressをインストールできます。ほとんどのデータベース情報は、コアコンポーネントのインストール後にサイトを作成するときに構成します。
  • Remote PC Access: ユーザーがオフィスにある物理マシンにリモートでアクセスできるようにする環境を展開する場合。
  • Connections and resources: アプリケーションとデスクトップ用のVMをホストまたはプロビジョニングするためにハイパーバイザーまたはその他のサービスを使用している場合。最初の接続は、サイトを作成するとき(コアコンポーネントのインストール後)に構成できます。それまでに仮想化環境をセットアップしてください。
  • Microsoft System Center Configuration Manager: アプリケーションとデスクトップへのアクセスを管理するためにConfigMgrを使用している場合、またはRemote PC AccessでWake on LAN機能を使用している場合。
  • パブリッククラウドホスト接続: ハイブリッドライツライセンスをお持ちの場合、パブリッククラウドへのホスト接続を作成できます。ハイブリッドライツライセンスに関する情報については、Hybrid Rights Renewalsを参照してください。パブリッククラウドの資格とこの変更の理由に関する情報については、CTX270373を参照してください。

コンポーネントのインストール場所

サポートされているプラットフォーム、オペレーティングシステム、およびバージョンについては、System requirementsを確認してください。コンポーネントの前提条件は、特に記載がない限り自動的にインストールされます。サポートされているプラットフォームと前提条件については、Citrix StoreFrontおよびCitrix License Serverのドキュメントを参照してください。
コアコンポーネントは、同じサーバーまたは異なるサーバーにインストールできます。
  • すべてのコアコンポーネントを1つのサーバーにインストールすることは、評価、テスト、または小規模な本番展開で機能します。
  • 将来の拡張に対応するために、コンポーネントを異なるサーバーにインストールすることを検討してください。たとえば、Controllerをインストールしたサーバーとは別のマシンにStudioをインストールすると、サイトをリモートで管理できます。
  • ほとんどの本番展開では、コアコンポーネントを個別のサーバーにインストールすることをお勧めします。
    他のサーバーに他のコンポーネントをインストールする前に、Citrix License Serverとライセンスをインストールします。
  • Server CoreOS(Delivery Controllerなど)にサポートされているコンポーネントをインストールするには、(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/install-configure/install-core/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をインストールまたはアップグレードしようとすると、オプションを説明する記事へのメッセージが表示されます。

権限とActive Directoryの要件

コンポーネントをインストールするマシンでは、ドメインユーザーであり、ローカル管理者である必要があります。
スタンドアロンVDAインストーラーを使用するには、管理者権限を昇格させるか、管理者として実行を使用する必要があります。
インストールを開始する前に、Active Directory ドメインを構成してください。
  • (/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/system-requirements.html) には、サポートされているActive Directoryの機能レベルが記載されています。詳細については、(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-identities/active-directory.html) を参照してください。
  • Active Directory Domain Servicesを実行しているドメインコントローラーが少なくとも1つ必要です。
  • ドメインコントローラーにCitrix Virtual Apps and Desktopsコンポーネントをインストールしないでください。
  • Studioで組織単位名を指定する際に、スラッシュ (/) を使用しないでください。
Citrix License Serverのインストールに使用されるWindowsユーザーアカウントは、委任管理のフル管理者として自動的に構成されます。
詳細情報:
  • (/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/secure/best-practices.html)
  • (/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/manage-deployment/delegated-administration.html)
  • Active Directory構成に関するMicrosoftドキュメント

インストールのガイダンス、考慮事項、およびベストプラクティス

いずれかのコンポーネントのインストール中

  • フルプロダクトメディアから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のインストール中

  • VDAをインストールしても、Windows向けCitrix Workspace™アプリは利用可能ですが、デフォルトではインストールされません。ユーザーは、Citrix WebサイトからWindows向けCitrix Workspaceアプリおよびその他のCitrix Workspaceアプリをダウンロードしてインストール(およびアップグレード)できます。または、StoreFrontサーバーからこれらのCitrix Workspaceアプリを利用可能にすることもできます。StoreFrontのドキュメントを参照してください。
  • Microsoft Print Spoolerサービスを有効にする必要があります。このサービスが無効になっている場合、VDAを正常にインストールすることはできません。
  • Windows Protected Print (WPP) モードを無効にする必要があります。WPPモードが有効になっている場合、VDAを正常にインストールすることはできません。
  • ほとんどのサポートされているWindowsエディションには、Microsoft Media Foundationがすでにインストールされています。マシンにMedia Foundationがない場合(Nエディションなど)、いくつかのマルチメディア機能はインストールされず、動作しません。
    • Windows Mediaリダイレクト
    • HTML5ビデオのリダイレクト
    • HDX™ RealTimeウェブカメラのリダイレクト
    制限を承諾するか、VDAのインストールを終了して、Media Foundationのインストール後に再開することができます。グラフィカルインターフェイスでは、この選択肢はメッセージで表示されます。コマンドラインでは、/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 コンポーネントをインストールします。
  • Federated Authentication Service をインストールします。
  • Session Recording をインストールします。
  • Workspace Environment Management をインストールします。
    注:
    Workspace Environment Management™ Agentインストーラーはローカライズされていません。英語でのみ利用可能です。
マルチセッションOSから1人のユーザー(Web開発など)にデスクトップを配信するには、製品版インストーラーのコマンドラインインターフェイスを使用します。詳細については、Server VDI を参照してください。

スタンドアロンVDAインストーラー

スタンドアロンVDAインストーラーは、Citrixダウンロードページで入手できます。(製品インストールメディアからは入手できません。)スタンドアロンVDAインストーラーは、製品版ISOよりもはるかに小さく、次のような展開に容易に対応できます。
  • ステージングまたはローカルにコピーされた電子ソフトウェア配布(ESD)パッケージを使用する
  • 物理マシンがある
  • リモートオフィスがある
デフォルトでは、自己解凍型スタンドアロンVDAのファイルはTempフォルダーに抽出されます。Tempフォルダーに抽出する場合、製品版インストーラーを使用する場合よりも多くのディスク容量がマシンに必要です。ただし、Tempフォルダーに抽出されたファイルは、インストール完了後に自動的に削除されます。または、絶対パスを指定して/extract コマンドを使用することもできます。
4つのスタンドアロンVDAインストーラーをダウンロードできます。
マルチセッションOS Virtual Delivery Agent (VDAServerSetup.exe):
マルチセッションOS用のVDAをインストールします。フルプロダクトインストーラーで利用可能な、マルチセッションOS用VDAのすべてのオプションをサポートします。
シングルセッションOS Virtual Delivery Agent (VDAWorkstationSetup.exe):
シングルセッションOS用のVDAをインストールします。フルプロダクトインストーラーで利用可能な、シングルセッションOS用VDAのすべてのオプションをサポートします。
シングルセッションOSコアサービス Virtual Delivery Agent (VDAWorkstationCoreSetup.exe):
リモートPCアクセス展開またはコアVDIインストール用に最適化されたシングルセッションOS用VDAをインストールします。リモートPCアクセスは物理マシンを使用します。コアVDIインストールは、イメージとして使用されていないVMです。このような展開のVDA接続に必要なコアサービスのみをインストールします。そのため、フルプロダクトインストーラーまたはVDAWorkstationSetup.exeインストーラーで有効なオプションのサブセットのみをサポートします。
このインストーラーは、以下のコンポーネントをインストールまたは含みません。
  • アプブイ。
  • プロファイル管理。Citrix Profile Managementをインストールから除外すると、Citrix Directorの表示に影響します。詳細については、「VDAのインストール」を参照してください。
  • マシンIDサービス。
  • シトリックス MCS IOドライバー
  • シトリックス バックアップとリストア
  • deviceTRUST
  • uberAgent
  • WEM
VDAWorkstationCoreSetup.exe インストーラーは、以下のコンポーネントをインストールまたは含んでいません:Citrix Workspace app for Windows (CWA)、Citrix Secure Access Client (CSA)、Citrix User Personalization Layer (UPL)。
VDAWorkstationCoreSetup.exe を使用することは、フルプロダクトまたは VDAWorkstationSetup インストーラーを使用してシングルセッションOS VDAをインストールすることと同等であり、以下のいずれかに該当します。
  • グラフィカルインターフェイスの場合: ページで オプションを選択します。
  • コマンドラインインターフェイスの場合:/remotepc オプションを指定します。
  • コマンドラインインターフェイスの場合:/components vda と、有効な追加コンポーネント名をすべてリストする /exclude オプションを指定します。
省略されたコンポーネント/機能は、後でフルプロダクトインストーラーを実行してインストールできます。この操作により、不足しているすべてのコンポーネントをインストールできます。
VDAWorkstationCoreSetup.exe インストーラーは、Browser Content Redirection MSI を自動的にインストールします。この自動インストールは、VDA リリース 2003 以降のサポート対象リリースに適用されます。
シングルセッションコアサービスVirtual Delivery Agent (VDASingleSessionCoreSetup.exe):
リリース 2507 CU1 以降、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ライセンスサーバーを構成するには:
  1. 利用可能なマシンにリモートデスクトップサービスライセンスサーバーをインストールします。このマシンは常に利用可能である必要があります。Citrix製品のワークロードは、このライセンスサーバーに到達できる必要があります。
  2. Microsoftグループポリシーを使用して、ライセンスサーバーのアドレスとユーザーごとのライセンスモードを指定します。詳しくは、Microsoftドキュメント「RDセッションホストサーバーのリモートデスクトップライセンスモードを指定する」を参照してください。
Windows 10ワークロードには、適切なWindows 10ライセンスのアクティブ化が必要です。Windows 10ワークロードをアクティブ化するには、Microsoftのドキュメントに従うことをお勧めします。

詳細情報

特定のホストタイプのリソースの場所を設定する場合: