VUSを使用したVDAアップグレードの前提条件
VUSを使用してVDAアップグレードを実行するには、以下の前提条件を満たす必要があります。
サイトの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を有効にする際に、以下のアップグレードサイクルから選択する必要があります。
- エルティーエスアール
- CR
- LTSR 早期アクセスリリース (EAR)
- シーアール イーエーアール
Web StudioからマシンカタログのVDAアップグレードサービスを有効にするには、カタログを右クリックし、「カタログの編集」をクリックし、「VDAアップグレードサービス」タブを選択し、「VDAアップグレードサービスを使用」チェックボックスをオンにして、アップグレードトラックを選択します。
VDAアップグレードサービス(/ja-jp/citrix-virtual-apps-desktops/2511/media/vda-upgrade-service-prereq.png)
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 name: CitrixUpgradeAgent_x64.msi
- Path: x64\Virtual Desktop Components
アクセス権限
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インストーラーが有効な証明書によって署名されていることを確認するには、VDAは次のURLと通信できる必要があります。
- VDAがインターネットにアクセスできない場合は、証明書失効リスト(CRL)をバイパスするようにVDAを構成してください。
- 「VDAアップグレード証明書失効リストチェック」Citrix®ポリシー設定を無効にし、デリバリーグループに割り当てます。
- ポリシーの説明:
- 有効にすると、VDAアップグレードエージェントはコンポーネントのアップグレード中に証明書失効リストチェックを実行します。
- 無効にすると、VDAアップグレードエージェントはこれらのチェックをスキップします。インターネットにアクセスできないVDAの場合は、この設定を無効にしてください。

- ポリシーの説明:
- 「VDAアップグレード証明書失効リストチェック」Citrix®ポリシー設定を無効にし、デリバリーグループに割り当てます。
プロキシ構成を持つ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
-
プロキシアドレス:
- 例えば、次のとおりです。
-
値の型:
-
キー:
- Web Studioを使用したVDAアップグレードエージェントのプロキシ構成。
VDAWorkstationCoreSetup.exe というインストーラーを使用してインストールされた VDA
VDAがVDAWorkstationCoreSetup.exeを使用して最初にインストールされた場合でも、VDAWorkstationSetup.exeを利用するVUSを使用してアップグレードできます。
VUSを使用してVDAWorkstationCoreSetup.exeでインストールされたVDAをアップグレードする際は、インストールオプションを確認して、必要な機能のみが有効になっていることを確認してください。特に、最小限のコアインストールから移行する場合は重要です。