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 以降

プロビジョニングの種類

  • 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

VDAがプロキシ経由でインターネットにアクセスする場合、VDAアップグレードエージェントがそのプロキシ経由でトラフィックを送信するように構成します。Hostname: Port (IP:Port) およびPACファイルの形式のプロキシのみがサポートされています。SOCKS5プロキシはサポートされていません。
Web Studioまたはレジストリを介してプロキシを使用するようにVDAアップグレードエージェントを構成します。
  • Web Studioを使用したVDAアップグレードエージェントのプロキシ構成。
    • ポリシーの作成ページで、設定からVDAアップグレードプロキシ構成設定を選択します。
    VDAアップグレードプロキシ構成設定を選択
    • プロキシを使用するVDAの設定を有効にします。この設定はデフォルトで無効になっています。
    VDAアップグレードプロキシ構成設定を有効にする
    • 設定でプロキシアドレスまたは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をアップグレードする際は、特に最小限のコアインストールから移行する場合、必要な機能のみが有効になっていることを確認するために、インストールオプションを確認する必要があります。