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

最終公開日 : Oct 24, 2026
ターゲットのマシンカタログ、個々のマシン、またはマシンのグループを選択し、「VDA のアップグレード」を選択することで、VDA アップグレードサービスを通じて VDA のアップグレードを開始できます。
注:
Citrix® は、可能な場合はアップグレードを実行する前に VDA をバックアップすることを推奨します。

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

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

考慮事項

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

タグ付けされたマシンへのアップグレードを制限する

マシンカタログレベルでは、選択したマシンタグを持つマシンのみに VDA アップグレードを制限できるようになりました。
Web Studio でカタログレベルのアップグレードを開始するときは、「タグに一致するマシンをアップグレード」を選択します。 「すべてのマシンをアップグレード」ではなく、タグピッカーからタグを選択します。
選択したタグを持つそのカタログ内のマシンのみがアップグレードのスコープに含まれます。
このオプションは、CR および LTSR の両方のアップグレードトラックをサポートしています。
このオプションは、リングベースのロールアウト戦略において、新しい VDA バージョンをパイロットサブセットで検証したい場合に フルカタログのアップグレードをスケジュールする前に使用します。

範囲

  • カタログレベルのアップグレードでのみ利用可能です。
  • デリバリーグループレベルのアップグレードでは利用できません。
  • 個々のマシンレベルのアップグレードでは利用できません。

UIの動作

「タグに一致するマシンをアップグレード」を選択すると、次のようになります。
  • タグピッカーが表示され、選択したカタログに存在するタグが表示されます。
  • スケジュールページのマシン数は、範囲内のタグ付けされたマシンのみを反映します。
  • 概要ページのマシン数は、範囲内のタグ付けされたマシンのみを反映します。

主な違い

機能 カタログごとのアップグレード マシンごとのアップグレード マシンのグループ
アップグレードの範囲 カタログ全体 個々のマシン マシンカタログ内のマシンのグループ
スケジュール制御 単一のスケジュールがマシンカタログ内のすべてのVDAに適用され、大規模なアップグレード操作に最適です VDAは個別にスケジュールされ、主にテストや1回限りのアップグレードに使用されます VDAはグループでスケジュールされ、異なるVDAグループを異なる時間にアップグレードする柔軟性を提供します
管理 完全構成インターフェイスのマシンカタログノード、またはNew-VusCatalogScheduleコマンドレットを介して管理されます 完全構成インターフェイスの検索ノード、またはNew-VusMachineUpgradeコマンドレットを介して管理されます 完全構成インターフェイスの検索ノード、またはマシンのリストを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をアップグレードする必要があるかどうかを判断するために、定期的にCitrix Cloud™と通信します。 VDAは、すぐにアップグレードするようにスケジュールすることも、最大7日前までにスケジュールすることもできます。事前にアップグレードをスケジュールする場合、アップグレードが開始される日付と時刻(UTC)を設定できます。
アップグレード期間は、スケジュールされたアップグレード開始時刻からアップグレードが実行されるまでの時間を設定します。デフォルトでは、マシンカタログおよびマシンのグループのアップグレードの場合、Citrixはパフォーマンスを向上させ、ボトルネックを回避するために、アップグレード期間全体にわたってVDAアップグレードの負荷分散を行います。
アップグレードが開始されると、VDAはアップグレードが完了するまでメンテナンスモードになります。VDAでセッションが実行されている場合、セッションがなくなるまでVDAはアップグレードされません。メンテナンスモードの間は、新しいセッションをVDAに仲介することはできません。アップグレード期間中にユーザーがセッションから切断した場合、アップグレードが完了するまで再接続できません。
VDAは、スケジュールされたアップグレード期間が完了するまでアップグレードを試行し続けます。アップグレード期間全体にわたってセッションが存在する場合、アップグレードはキャンセルされ、VDAのメンテナンスモードはオフになります。VDAアップグレードの成功率を向上させるために、より長いアップグレード期間を検討してください。
注:
スケジュールされたアップグレードの前に手動でメンテナンスモードに設定されたVDAは、アップグレードに失敗します。

利用可能なVDAバージョン

新しいVDAバージョンが一般提供されてから間もなく、VDAアップグレードサービスを通じてアップグレードできるようになります。VDAアップグレードサービスは、CRバージョンではVDAのN-2バージョンを、現在サポートされているすべてのLTSRバージョンではN-2 CUバージョンを維持します。
VDAのアップグレードウィザードには、選択した各VDAの現在のオペレーティングシステムと互換性のあるターゲットバージョンのみが表示されます。VDAのオペレーティングシステムのサポートを削除したターゲットは、そのVDAには表示されません。
フル構成インターフェイスでは、カタログまたは個々のマシンのいずれかをアップグレードする際に、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インストールメディアをCitrixホスト型CDNまたはローカルファイル共有のいずれかからダウンロードするように選択できます。
ローカルでホストされたファイル共有を介したアップグレードは、VDAがインストールメディアを取得できるようにするためのネットワークルール提供の要件を軽減し、アップグレードプロセス中の帯域幅使用量を削減できます。
Citrixホスト型CDNを使用する場合、VDAはConnectivityに記載されているURLと通信できる必要があります。
ローカルファイル共有を使用する場合、そのファイル共有には以下の前提条件が必要です。
  • VDAアップグレードエージェントはバージョン7.40.0.35以降である必要があり、これはVDAバージョン2311以降にデフォルトでインストールされます。
    • VDAアップグレードエージェントは、アップグレードのためにスケジュールされたVDAアップグレードを必要としません。VDAアップグレードエージェントは自動的に更新されます。
  • PowerShellを使用してアップグレードする場合は、Virtual Apps and Desktops Remote PowerShell SDKバージョン7.42以降がインストールされている必要があります。
  • ファイル共有のアクセス許可
    • 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コマンドレットを使用します。
フル構成インターフェイスでVDAをローカルファイル共有からアップグレードするように設定するには、VDAインストーラーの場所で「Use local file share」を選択し、インストーラーへのパスを入力します。例: "\\hostname\VDA-Packages\VDAWorkstationSetup_2308.exe"。
VUS5
PowerShellを使用してVDAをローカルファイル共有からアップグレードするように設定するには、アップグレードをスケジュールする際に-VdaWorkstationPackageUri (シングルセッションOS) または -VdaServerPackageUri (マルチセッションOS) パラメーターを使用します。

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

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

アップグレードを開始する前に VDA を再起動する

アップグレード前に VDA を自動的に再起動するオプションを使用して、各 VDA がクリーンで一貫した状態でプロセスを開始するようにすることで、成功率を向上させます。アップグレード前の再起動は、保留中の再起動、残存プロセス、不完全なシステム更新などの一般的な障害のリスクを軽減できます。
このオプションが有効になっている場合、各 VDA は全体のアップグレード期間の開始時ではなく、アップグレードが開始される直前に個別に再起動されます。
アップグレード前に VDA を再起動する機能を使用するには、VDA アップグレードエージェントがバージョン 7.44 (Citrix Virtual Apps and Desktops 2503 でリリース) 以降である必要があります。以前の VDA アップグレードエージェントバージョンの VDA は、再起動なしでアップグレードされます。

VDA をアップグレードするためにマシンを電源オンにする

VDA アップグレードをスケジュールする際、VDA Upgrade Service を構成して、アップグレード期間の開始時に現在電源がオフになっているか休止状態のマシンを自動的に電源オンにすることができます。
デフォルトでは、VDA Upgrade Service は電源がオンになっているマシンのみをアップグレードします。電源がオフになっているか休止状態のマシンはスキップされ、カタログの一部が次のアップグレード期間まで古い VDA バージョンで実行されたままになる可能性があります。このオプションを有効にすると、これらのマシンがアップグレード実行に含まれるようになります。

仕組み

アップグレード期間の開始時に、VDAアップグレードサービスは、スケジュール対象範囲内で電源がオフまたは休止状態になっているすべてのマシンを起動し、カタログの残りのマシンとともにアップグレードします。アップグレードが完了すると、各マシンは以前の電源状態に戻ります。ただし、これはカタログまたはデリバリーグループに電源管理ポリシーが構成されている場合に限ります。VDAアップグレードサービス自体はマシンをシャットダウンしません。

このオプションを有効にするには

Studioでアップグレードスケジュールを作成または編集する際に、スケジュールを確定する前に、スケジュールオプションで「VDAをアップグレードするためにマシンを起動する」を選択します。
電源オン
注:
アップグレード期間の開始時にすでに電源がオンになっているマシンは、この設定の影響を受けません。
マシンは、電源管理ポリシーが設定されている場合にのみ、アップグレード前の電源状態(オフまたは休止状態)に戻ります。ポリシーが構成されていない場合、アップグレード完了後もマシンは電源がオンのままになります。
このオプションは、カタログレベルとマシンレベルの両方のアップグレードスケジュールに適用されます。

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

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