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 アップグレードサービスを使用」チェックボックスをオンにして、アップグレードトラックを選択します。

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登録 を使用して追加されたマシン向け
- 2311以降
- 手動でプロビジョニングされたマシン向け
- 2411以降
プロビジョニングタイプ
- Citrix以外のプロビジョニング™サービスまたは を使用してプロビジョニングされたシングルセッションまたはマルチセッションの永続マシン。
- シングルセッションのMCSプロビジョニングされた永続マシン(AD参加済み、Azure AD参加済み、およびドメイン非参加)。
- リモート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インストーラーが有効な証明書で署名されていることを確認するには、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をアップグレードする際は、特に最小限のコアインストールから移行する場合、必要な機能のみが有効になっていることを確認するためにインストールオプションを確認する必要があります。