VDAアップグレードサービスを使用したVDAのアップグレード

最終公開日 : Nov 13, 2026
ターゲットマシンカタログ、個々のマシン、またはマシンのグループを選択し、その後「VDAのアップグレード」を選択することで、VDAアップグレードサービスを介してVDAアップグレードを開始できます。
注:
Citrix® は、可能な場合はアップグレードを実行する前に VDA をバックアップすることを推奨します。
Related information
Citrix VDA Upgrade Service (VUS) - テクニカルプレビュー

アップグレードのスケジュール設定

CitrixにおけるVDAアップグレードプロセスは、要件に応じて、カタログレベル、マシンのグループレベル、または個々のマシンレベルで実行できます。アップグレードはすぐに開始するように設定することも、最大7日前までに日時を指定してスケジュールすることもできます。

考慮事項

  • カタログ vs. マシンのグループ vs. マシンのスコープ: カタログアップグレードは一括更新に最適ですが、個別に、またはグループでマシンをアップグレードすると、よりきめ細かな制御が可能になります。
  • スケジュール設定: アップグレードは最大7日前までにスケジュールできます。マシンカタログレベルのアップグレードを使用している場合、アップグレードがスケジュールされた後にカタログに追加されたマシンは、既存のスケジュールされたアップグレードの一部として含まれません。

主な違い

機能 カタログごとのアップグレード マシンごとのアップグレード マシンのグループ
アップグレードの範囲 カタログ全体 個々のマシン マシンカタログ内のマシンのグループ
スケジュール制御 単一のスケジュールがマシンカタログ内のすべてのVDAに適用され、大規模なアップグレード操作に最適です VDAは個別にスケジュールされ、主にテストや1回限りのアップグレードに使用されます VDAはグループでスケジュールされ、異なるVDAグループを異なる時間にアップグレードする柔軟性を提供します
管理 Web Studioの「マシンカタログ」ノードまたはNew-VusCatalogScheduleコマンドレットを介して管理されます Web Studioの「検索」ノードまたはNew-VusMachineUpgradeコマンドレットを介して管理されます Web Studioの「検索」ノード、またはマシンのリストをNew-VusMachineUpgradeコマンドレットに渡すことで管理されます
ユースケース マシンカタログ全体のバルクアップグレード ターゲットを絞ったアップグレードとテストシナリオのためのきめ細かい制御 VDAのサブセットを対象とした制御。カタログ内のアップグレードを段階的に実行するために使用できます
利用可能な VDA バージョン CR および現在サポートされているすべての LTSR VDA バージョンでは、最新バージョンと 2 つ前の (N-2) バージョンにアップグレードできます。詳細については、利用可能な VDA バージョン を参照してください。 CR および現在サポートされているすべての LTSR VDA バージョンでは、最新バージョンと 2 つ前の (N-2) バージョンにアップグレードできます。詳細については、利用可能な VDA バージョン を参照してください。 最新の LTSR または CR VDA バージョンのみがアップグレード可能です
追加コンポーネント 各 VDA に VDA コンポーネントをインストールまたはアップグレードします。コンポーネントのチェックを外しても機能はアンインストールされませんが、コンポーネントはアップグレードされません VDA 上の VDA コンポーネントをインストールまたはアップグレードします。コンポーネントのチェックを外しても機能はアンインストールされませんが、コンポーネントはアップグレードされません マシンのグループをアップグレードする場合、追加コンポーネントは VDA アップグレードサービスによって管理できません。注: 「復元クリーンアップを有効にする」などの追加機能は、マシンのグループのアップグレードで利用できます
追加機能 追加機能を有効またはアップグレードできます 追加機能を有効またはアップグレードできます 追加機能を有効またはアップグレードできます
同時実行 アップグレードのスケジュール設定時に設定として制御されます。詳細については、同時実行 を参照してください 単一の VDA がアップグレードされます アップグレードスケジュールの一部として選択されたVDAの数に基づいて自動的に負荷分散されます
失敗しきい値 指定された数のVDAのアップグレードが失敗した場合に、それ以降のアップグレードを防止するために失敗しきい値を設定できます。詳細については、「失敗しきい値」を参照してください。 失敗しきい値は、マシンごとのアップグレードには適用されません。 失敗しきい値は、マシンのグループのアップグレードには使用できません。アップグレードするマシンのグループのサイズを、許容できる失敗数となるVDAの最大数に設定することを検討してください。

スケジュールされたアップグレードの仕組み

VDA上のVDAアップグレードエージェントは、VDAをアップグレードする必要があるかどうかを判断するために、定期的にDelivery Controllerと通信します。 VDAは、すぐにアップグレードするように、または最大7日前にアップグレードするようにスケジュールできます。事前にアップグレードをスケジュールする場合、アップグレードが開始される日付と時刻（UTC）を設定できます。
アップグレード期間は、スケジュールされたアップグレード開始時刻からアップグレードが実行されるまでの時間を設定します。デフォルトでは、マシンカタログおよびマシンのグループのアップグレードの場合、Citrixはパフォーマンスを向上させ、ボトルネックを回避するために、アップグレード期間全体にわたってVDAアップグレードの負荷分散を行います。
アップグレードが開始されると、VDAはアップグレードが完了するまでメンテナンスモードになります。VDAでセッションが実行されている場合、セッションがなくなるまでVDAはアップグレードされません。メンテナンスモードの間は、新しいセッションをVDAに仲介することはできません。アップグレード期間中にユーザーがセッションから切断した場合、アップグレードが完了するまで再接続できません。
VDAは、スケジュールされたアップグレード期間が完了するまでアップグレードを試行し続けます。アップグレード期間全体にわたってセッションが存在する場合、アップグレードはキャンセルされ、VDAのメンテナンスモードはオフになります。VDAアップグレードの成功率を向上させるために、より長いアップグレード期間を検討してください。
注:
スケジュールされたアップグレードの前に手動でメンテナンスモードに設定されたVDAは、アップグレードに失敗します。

利用可能なVDAバージョン

VDAアップグレードサービスは、CRバージョンではVDAのN-2バージョンを、現在サポートされているすべてのLTSRバージョンではN-2 CUバージョンを維持します。
新しいCVADバージョンがリリースされた場合、サイト全体を更新することなく、VUSを更新してより新しいVDAバージョンを含めることができます。VUSはvda_releases.xmlファイルを使用して、利用可能なVDAバージョンを投入します。vda_releases.xmldファイルは、CVADメタインストーラーの次の場所にあります。
<CVAD-ISO\>\Support\VdaUpdateServiceMetadata\vda_releases.xml
新しいvda_releases.xmlファイルをVUSにインポートするには、次のコマンドレットを実行します。 Import-VusVdaReleasesMetadata -Path ‘[Path to vda_releases.xml]’
Web Studioで、カタログまたは個々のマシンをアップグレードする際、UIはVDAをアップグレードするバージョンを尋ねます。
VUS1
PowerShell を使用して利用可能なVDAバージョンを特定するには、Get-VusAvailableVdaVersion コマンドレットを使用します。
コマンドレットにマシンまたはカタログを渡さない場合、コマンドレットはすべてのアップグレードトラックで利用可能な最新バージョンを返します。
リソースで利用可能な特定のバージョンを取得するには、Get-VusAvailableVdaVersionコマンドレットでVDA（-MachineName、-MachineUid、または-MachineUuid）またはカタログ（-CatalogName、-CatalogUid、または-CatalogUuid）を渡します。
例: Get-VusAvailableVdaVersion -CatalogName ‘[Name of your Machine Catalog]’
VUS2

追加コンポーネント

追加コンポーネントは、マシンカタログまたは個々のマシンによってVDAをアップグレードする際にインストールまたはアップグレードできます。コンポーネントをチェックしない場合、そのコンポーネントはアンインストールされませんが、VDA全体のアップグレードの一部としてアップグレードされません。
VUS3

機能

機能は、VDAアップグレードサービスを通じてVDAで有効化またはアップグレードできます。機能をチェックしない場合、その機能は無効になりませんが、VDA全体のアップグレードの一部としてアップグレードされません。
デフォルトでは、Enable restore cleanupチェックボックスが選択されています。Citrixは、管理を容易にし、失敗したアップグレードの回復を改善するために、復元クリーンアップ機能を有効にすることをお勧めします。この機能を有効にすると、アップグレードが開始される前にシステム復元ポイントが作成されます。アップグレードが失敗した場合、VDAはシステム復元ポイントに復元されます。復元ポイントは、VDAのインストールが成功した後に削除されます。詳細については、「インストールまたはアップグレードの失敗時の復元」を参照してください。
VUS4
注:
Windows システムの復元は、シングルセッションオペレーティングシステム (例: Windows 10 および 11) でのみサポートされています。「復元のクリーンアップを有効にする」機能が動作するためには、VDA で Windows システムの復元機能が有効になっている必要があります。「復元を有効にする」または「復元のクリーンアップを有効にする」が選択されていても、VDA で Windows システムの復元が構成されていない場合、アップグレードが失敗する可能性があります。

同時実行数

マシンカタログをアップグレードする際、VUSを使用すると、同時にアップグレードするVDAの最大数を定義できます。これにより、インターネット接続やファイルサーバーへの負荷を軽減でき、障害しきい値と組み合わせて使用することで、多数のVDAのアップグレードが失敗した場合にアップグレードを停止できます。
スケジュールされたアップグレードが開始されるとすぐに、カタログ内のすべてのVDAはメンテナンスモードになります。定義された最大同時実行設定に一致する数のVDAでアップグレードが開始されます。VDAのアップグレードが完了するとすぐに、同時にアップグレードしているVDAの数を維持するために、別のVDAがアップグレードを開始します。
マシンカタログのスケジュールされたアップグレードで同時実行性が指定されていない場合、Citrixはカタログ内のVDAの総数とアップグレード期間に基づいてデフォルトの同時実行値を使用します。
アップグレードの完了には平均約30分かかりますが、これは環境条件によって大きく異なります。指定されたアップグレード期間内にすべてのVDAがアップグレードできるような同時実行数を設定することを検討してください。たとえば、4時間で20台のVDAをアップグレードするように設定されている場合、1時間あたり5台のVDAをアップグレードする必要があります。平均アップグレード期間が30分であるとすると、1時間あたり5台のVDAアップグレードという要件を満たすために、同時実行値を3に設定できます（30分あたり3回のアップグレードは、1時間あたり6回の更新になります）。

失敗しきい値

マシンカタログをアップグレードする際、障害しきい値を使用して、特定の数のVDAが失敗した場合にそれ以上のVDAがアップグレードされるのを防ぎます。障害しきい値は、アップグレードの失敗を引き起こす問題の影響範囲を縮小し、管理者のトラブルシューティング作業を軽減できます。
障害しきい値は、将来のVDAがアップグレードを開始するのを防ぎますが、すでにアップグレードを開始しているVDAを停止することはありません。たとえば、マシンカタログに100台のVDAがあり、同時実行が10台のVDAに設定され、障害しきい値が3に設定されている場合、すべてのVDAアップグレードが失敗すると、少なくとも13台のVDAがアップグレードを試行し、残りの87台は開始されず、アップグレードはキャンセルされます。
スケジュールされたアップグレードの開始時に10台の同時実行VDAがアップグレードを開始し、最初のアップグレードが失敗した場合、10台の同時実行アップグレードを維持するために別のVDAがアップグレードを開始します。2番目のアップグレードが失敗した場合、別のVDAがアップグレードを開始します。3番目のアップグレードが失敗した場合、現在アップグレードプロセス中のすべてのVDAは続行され、アップグレードスケジュール内の残りのVDAのアップグレードはキャンセルされます。

VDAインストーラーの場所

VDAインストーラーは、環境内のローカルファイル共有でホストされている必要があります。ファイル共有とVDAインストーラーの要件は以下のとおりです。
ファイル共有には、次の前提条件が必要です。
  • ファイル共有のアクセス許可
    • VDAインストーラーパッケージを含むネットワーク共有には、ローカルシステム (NT AUTHORITY\SYSTEMプリンシパル) として実行されるVDAアップグレードエージェントサービスに対する読み取りアクセス権が必要です。
    • ドメイン参加済みVDA:
      • ローカルシステムアカウント (VUAはローカルシステムとして実行されます) は、ネットワーク共有にアクセスする際にコンピューターの資格情報を使用します。
      • ファイル共有には、ドメインコンピューターに対する読み取りアクセス権を付与する必要があります。
      • 共有の詳細設定で、ファイルとプリンターの共有を有効にする必要があります。
    • ドメイン非参加VDA:
      • ローカルシステムアカウント (VUAはローカルシステムとして実行されます) は、ネットワーク共有にアクセスする際にANONYMOUS LOGONを使用します。
      • ネットワークと共有センター、パスワード保護共有は無効にする必要があります。
      • フォルダーのアクセス許可のセキュリティタブで、ANONYMOUS LOGONに読み取りアクセス許可を付与する必要があります。
      • 詳細共有設定で、ファイルとプリンターの共有を有効にする必要があります。
      • 共有フォルダー名は、ネットワークアクセスセキュリティポリシーに追加する必要があります。
  • VDAインストーラー
    • VDAインストーラーは、Citrix Downloads Webサイトからダウンロードし、ファイル共有に配置する必要があります。
    • マシンカタログに関連するVDAインストーラーをダウンロードする必要があります。
      • カタログタイプがマルチセッションの場合は、Multi-session OS VDA installerを使用します。
      • カタログタイプがシングルセッションの場合は、Single-session OS VDA installerを使用します。
    • 特定のアップグレードの場合、ファイル共有上のインストーラーのバージョンは、VUSによって公開されているバージョンと完全に一致している必要があります。利用可能なバージョンを確認するには、Get-VusAvailableVersion PowerShellコマンドレットを使用します。
インストーラーへのパスは、実行可能ファイルを含むファイルパスである必要があります。例: \\hostname\VDA-Packages\VDAWorkstationSetup_2308.exe。
VUS5
PowerShellを介してVUSを使用する場合、アップグレードをスケジュールするときに、-VdaWorkstationPackageUri (シングルセッションOS) または -VdaServerPackageUri (マルチセッションOS) パラメーターを使用します。

セッションの強制ログオフ

スケジュールされたアップグレード中にアップグレード可能なVDAの数を増やすには、アップグレード中にユーザーセッションを強制的にログオフすることを検討してください。強制ログオフは、個々のVDAのアップグレードが開始されるときに発生し、全体のスケジュールされたアップグレード期間の開始時ではありません。
スケジュールされた期間内で異なるVDAが異なる時間にアップグレードを開始するため、ユーザーは自身の特定のVDAのアップグレードが開始されたときにのみログオフされます。
Web Studioを使用してスケジュールされたアップグレード中に切断されたセッションを強制的にログオフするには、 オプションを選択します。
Web Studioを使用してスケジュールされたアップグレード中にアクティブなセッションを強制的にログオフするには、「アクティブなセッションをログオフする」オプションを選択します。アクティブなセッションをログオフする場合、ユーザーはアップグレード開始の10分前にセッション内で通知を受け取り、自動的にログオフされる前に作業を保存するよう促されます。
VUS6
PowerShellを使用してスケジュールされたアップグレード中に切断されたセッションを強制的にログオフするには、アップグレードをスケジュールするときに-LogoffOptionパラメーターを使用します。-LogoffOptionで利用可能なオプションは以下のとおりです。
  • ActiveSessionsOnly: スケジュールされたアップグレード期間中にVDAでアクティブなセッションがある場合、ユーザーはログオフされます。ユーザーがログオフされる10分前に警告としてバナーが表示されます。切断されたセッションがあるVDAは、アップグレード期間中にログオフされません。切断されたセッションがアップグレード期間中ずっと残っている場合、そのVDAのアップグレードはキャンセルされます。
  • DisconnectedSessionsOnly: スケジュールされたアップグレード期間中にVDAで切断されたセッションがある場合、ユーザーはログオフされます。ユーザーには、切断されたセッションがログオフされることは通知されません。アクティブなセッションがあるVDAは、アップグレード期間中にログオフされません。アクティブなセッションがアップグレード期間中ずっと残っている場合、そのVDAのアップグレードはキャンセルされます。
  • ActiveAndDisconnectedSessions: スケジュールされたアップグレード期間中に VDA で切断されたセッションまたはアクティブなセッションがある場合、ユーザーはログオフされます。アクティブなセッションの場合、ユーザーがログオフされる 10 分前に警告としてバナーが表示されます。
  • DoNotLogoff: アクティブなセッションと切断されたセッションはログオフされません。アップグレードスケジュールの期間中ずっと VDA にセッションが存在する場合、スケジュールされたアップグレード期間の終了時にアップグレードはキャンセルされます。
可能な場合、Citrix は、アップグレードが正常に完了する VDA の数を増やすために、セッションを強制的にログオフすることを推奨します。
重要:
セッションを強制的にログオフすると、ユーザーがセッションから保存していない作業を失う可能性があります。

VDA ワークフローの編集またはキャンセル

カタログのアップグレードをスケジュールした後、アップグレードの開始時刻と期間を編集したり、アップグレードを完全にキャンセルしたりできます。
UI を使用してマシンカタログレベルでアップグレードを編集またはキャンセルするには、既存のスケジュールされたアップグレードがあるマシンカタログを右クリックし、「スケジュールされた VDA アップグレードの編集」をクリックします。PowerShell を使用して既存のマシンカタログレベルのアップグレードを編集するには、Set-VusCatalogUpgrade および Remove-VusCatalogUpgrade コマンドレットを使用します。
マシンレベルでアップグレードを編集またはキャンセルするには、検索ノードで、既存のスケジュールされたアップグレードがあるマシンを右クリックし、「スケジュールされた VDA アップグレードの編集」をクリックします。複数のマシンのスケジュールされた VDA アップグレードを同時に編集することはできません。PowerShell を使用して既存のマシンレベルのアップグレードを編集するには、Set-VusMachineUpgrade および Remove-VusMachineUpgrade コマンドレットを使用します。