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

最終公開日 : Nov 13, 2026
VUSを使用してVDAアップグレードを実行するには、以下の前提条件を満たす必要があります。
Related information
VDA アップグレードサービス (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アップグレードサービス」タブを選択し、「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参加済み、およびドメイン非参加)。
  • リモート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 (手動でプロビジョニングされたもの) は、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 を使用してアップグレードできます。
VUS を使用して VDAWorkstationCoreSetup.exe でインストールされた VDA をアップグレードする場合、インストールオプションを確認して、必要な機能のみが有効になっていることを確認する必要があります。特に、最小限のコアインストールから移行する場合は注意が必要です。