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

最終公開日 : Nov 13, 2026
VUS を使用して VDA アップグレードを実行するには、次の前提条件を満たす必要があります。
Related information
Citrix VDA Upgrade Service (VUS) - テクニカルプレビュー

サイトの 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参加済み、Azure AD参加済み、およびドメイン非参加）。
  • リモートPCアクセス マシン。

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経由でデリバリーコントローラーと通信できる必要があります。
    • 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 を使用してアップグレードできます。
VDAWorkstationCoreSetup.exe を使用してインストールされた VDA を VUS でアップグレードする場合は、特に最小限のコアインストールから移行する場合、目的の機能のみが有効になっていることを確認するために、インストールオプションを確認する必要があります。