VUS を使用して VDA をアップグレードする

最終公開日 : Nov 13, 2026
ターゲットのマシンカタログ、個々のマシン、またはマシンのグループを選択し、「VDA のアップグレード」を選択することで、VDA アップグレードサービスを通じて VDA のアップグレードを開始できます。
注:
Citrix® は、可能な場合はアップグレードを実行する前に VDA をバックアップすることを推奨します。
Related information
VDA アップグレードサービス (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バージョンを維持します。
VDAのアップグレードウィザードには、選択した各VDAの現在のオペレーティングシステムと互換性のあるターゲットバージョンのみが表示されます。VDAのオペレーティングシステムのサポートを削除したターゲットは、そのVDAには表示されません。
新しい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 コマンドレットを使用します。
コマンドレットにマシンまたはカタログを渡さない場合、コマンドレットはすべてのアップグレードトラックで利用可能な最新バージョンを返します。
リソースで利用可能な特定のバージョンを取得するには、VDA (-MachineName, -MachineUid または -MachineUuid) またはカタログ (-CatalogName, -CatalogUid, または -CatalogUuid) を Get-VusAvailableVdaVersion コマンドレットに渡します。
例: Get-VusAvailableVdaVersion -CatalogName ‘[Name of your Machine Catalog]’
VUS2

追加コンポーネント

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

機能

VDAアップグレードサービスを通じて、VDAの機能を有効化またはアップグレードできます。機能をチェックしない場合、その機能は無効化されませんが、VDA全体のアップグレードの一部としてアップグレードされることはありません。
デフォルトでは、復元クリーンアップを有効にする チェックボックスが選択されています。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分を使用すると、同時実行値を3に設定することで、1時間あたり5台のVDAアップグレード要件を満たすことができます（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インストーラーパッケージを含むネットワーク共有には、Local System (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コマンドレットを使用します。