VUS を使用した VDA アップグレードの前提条件

最終公開日 : Nov 13, 2026
VUS を使用して VDA アップグレードを実行するには、次の前提条件を満たす必要があります。

サイトで VDA アップグレードサービスを有効にする

2503 サイトで VUS を有効にするには、次の PowerShell コマンドレットを実行します。
Set-VusSite -Enabled $true
有効にしたら、次の PowerShell コマンドレットを実行して、最新の VDA バージョンを CVAD サイトにインポートします。
Import-VusVdaReleasesMetadata -Path ‘[<CVAD-2503-ISO>\Support\VdaUpdateServiceMetadata\vda_releases.xml]’

VDA アップグレードサービスを有効にする

VDA アップグレードサービス機能を有効にするには、マシンカタログの作成または編集時に VDA アップグレードオプションを使用します。管理者は、VUS を有効にする際に、次のアップグレードサイクルから選択する必要があります。
  • LTSR
  • CR
  • LTSR 早期アクセスリリース (EAR)
  • CR EAR
Web Studio からマシンカタログの VDA アップグレードサービスを有効にするには、カタログを右クリックし、 をクリックし、 タブを選択し、 チェックボックスをオンにして、アップグレードトラックを選択します。
VDA アップグレードサービス
PowerShell を使用してマシンカタログの VDA アップグレードサービスを有効にするには、Set-VusCatalogUpgradeType コマンドレットを使用します。
アップグレードの種類は、「LTSR」、「CR」、「EAR_CR」、または「EAR_LTSR」に設定できます。
例: Set-VusCatalogUpgradeType -CatalogName "Workstation catalog" -UpgradeType LTSR
注:
VDA アップグレードオプションを有効にしても、VDA が自動的にアップグレードされることはありません。VUS を介したすべての VDA アップグレードは、管理者によって明示的に実行される個別のタスクとして開始する必要があります。

VDAの要件

VDAのバージョン

  • MCS を使用して作成されたマシンの場合:
    • 2311 以降
  • Websocket VDA Enrollment を使用して追加されたマシンの場合
    • 2311 以降
  • 手動でプロビジョニングされたマシンの場合
    • 2411 以降

ソースVDAのオペレーティングシステム

VDAアップグレードサービスは、VDAの現在のオペレーティングシステムをシステム要件に含むターゲットバージョンのみを提供します。ターゲットバージョンでサポート対象外となったオペレーティングシステム(たとえば、CVAD 2407以降VDA OSとしてサポートされていないWindows Server 2016など)でVDAが実行されている場合、そのターゲットは提供されず、VDAは「最新の状態であり、利用可能なアップグレードはありません」と報告されます。そのようなVDAをアップグレードするには、サポートされているオペレーティングシステムに再イメージングしてください。各バージョンがサポートするオペレーティングシステムについては、そのバージョンのシステム要件とCTX224843を参照してください。

プロビジョニングの種類

  • Citrix 以外のプロビジョニング™サービスまたは を使用してプロビジョニングされた、シングルセッションまたはマルチセッションの永続マシン。
  • シングルセッションのMCSプロビジョニング済み永続マシン(AD参加済み、Microsoft Entra参加済み、およびドメイン非参加)。
  • Remote PC Accessマシン。

VDAアップグレードエージェント

  • VDA アップグレードエージェントバージョン 7.44 以降が VDA にインストールされ、アクティブになっている必要があります。エージェントは次のようにインストールできます。
    • VDAのアップグレード時、またはVDAのインストール変更時に、追加コンポーネントとして。
    • Citrix Virtual Apps and Desktops™ ISOで利用可能なスタンドアロンMSIを使用します。
      • MSI名:CitrixUpgradeAgent_x64.msi
      • パス: x64\仮想デスクトップコンポーネント

権限

CVAD でフル管理者またはマシンカタログ管理者ロールを持っている必要があります。

VDAの状態

VUSを介してスケジュールされたアップグレードが意図どおりに進行するには、アップグレード対象のVDAは次の前提条件を満たしている必要があります。
  • VDAは手動でメンテナンスモードに設定されていない必要があります。
  • VDAのアップグレードを正常に実行するには、ユーザーがログオンしていない必要があります。
    • アップグレードプロセスがアップグレードウィンドウ全体でユーザーセッションのドレインを開始すると、VDAはメンテナンスモードになります。アップグレードが正常に完了すると、メンテナンスモードから解除されます。
    • アップグレードウィンドウの期間中、ユーザーがアクティブまたは切断されたセッションを持っている場合、アップグレードはアップグレードウィンドウの終了時にキャンセルされます。
      注:
      アクティブおよび切断されたセッションは、VUSの強制ログオフオプションを使用して終了できます。
  • MCSを介してプロビジョニングされていないVDA(手動でプロビジョニングされたVDA)は、VUSを介してアップグレードを実行する前にデリバリーグループに追加する必要があります。
  • VDAは電源が入っている必要があります。
    注:
    VDAアップグレードがスケジュールされている場合でも、AutoScale™はマシンの電源管理を停止しません。アップグレードの進行中は、デリバリーグループのAutoScaleスケジュールを無効にすることを検討してください。

接続

  • VDA アップグレードの場合、VDA は HTTPS 経由で Delivery Controller と通信できる必要があります。
    • VDAインストーラーが有効な証明書によって署名されていることを確認するには、VDAは以下のURLと通信する必要があります。
      • <http://crl3.digicert.com/>*
      • <http://crl4.digicert.com/>*
      • <http://ocsp.digicert.com/>*
      • <http://cacerts.digicert.com/>*
  • VDAがインターネットにアクセスできない場合、証明書失効リスト (CRL) をバイパスするようにVDAを構成します。
    • 「VDAアップグレード証明書失効リストチェック」Citrix®ポリシー設定を無効にし、デリバリーグループに割り当てます。
      • ポリシーの説明:
        • 有効にすると、VDAアップグレードエージェントはコンポーネントのアップグレード中に証明書失効リストチェックを実行します。
        • 無効にすると、VDAアップグレードエージェントはこれらのチェックをスキップします。インターネットにアクセスできないVDAの場合は、この設定を無効にします。
        VUS接続性

プロキシ構成を持つVDA

  • ホスト名:ポート (IP:ポート) 形式のプロキシとPACファイルのみがサポートされています。SOCKS5プロキシはサポートされていません。
  • VDAアップグレードエージェントは、Web Studioまたはレジストリを使用してプロキシを使用するように構成する必要があります。
    • Web Studioを使用したVDAアップグレードエージェントのプロキシ構成。
      • プロキシを使用するVDAに対して、VDAアップグレードプロキシ構成のCitrixポリシー設定を有効にします。
      • 設定でプロキシアドレスまたはPACファイルへのパスを入力します。
    • レジストリを使用したVDAアップグレードエージェントのプロキシ構成
      • キー: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\VirtualDesktopAgent
        • 値の型: String
        • 値の名前: ProxySettings
        • 値のデータ: プロキシアドレスまたはPACファイルへのパス。
          • 例:
            • プロキシアドレス: http://<URL or IP>:\<port>
            • PACファイル: http://<URL or IP>/\<path/\<filename>.pac

VDAWorkstationCoreSetup.exe を使用してインストールされたVDA

VDAがVDAWorkstationCoreSetup.exeを使用して最初にインストールされた場合でも、VDAWorkstationSetup.exeを利用するVUSを使用してアップグレードできます。
VUSを使用してVDAWorkstationCoreSetup.exeでインストールされたVDAをアップグレードする場合、特に最小限のコアインストールから移行する場合は、必要な機能のみが有効になっていることを確認するために、インストールオプションを確認する必要があります。