Citrix DaaS™

PDFを表示

監視とトラブルシューティング

September 3, 2026

寄稿者:

C C

スケジュールされたVDAアップグレードの監視

VDAとマシンカタログには、VDAアップグレードの準備状況と現在のステータスを監視するのに役立つ2つの属性があります。これらは、Studioでフィルタリングしたり、VDAまたはカタログの詳細ペインで使用したりできる列として表示されます。

VDAアップグレード
VDAアップグレードの状態

VDAアップグレード

VDAアップグレードは、VDAまたはマシンカタログにVDAアップグレードエージェントが構成されているか、VDAが最新であるか、またはアップグレードが利用可能であるかに関する情報を提供します。利用可能なステータスは次のとおりです。

VDAアップグレード (Studio)	VDAアップグレード (Powershell)	説明
カタログレベル
未構成	MissingUpgradeType	マシンカタログのアップグレードトラック (CR、LTSR、CR EAR、またはLTSR EAR) が選択されていません。
スケジュール済み	アップグレードスケジュール済み	マシンカタログのアップグレードがスケジュールされています。
利用可能	アップグレード利用可能	カタログ内のVDAは、アップグレードトラックの最新バージョンではありません。アップグレードが推奨されます。
最新	最新	カタログ内のVDAは、アップグレードトラックの最新バージョンです。アクションは不要です。
不明	不明	最新のVDAアップグレード状態を取得しています。
マシンレベル
未構成	アップグレードタイプが不足	VDAのマシンカタログにアップグレードトラック（CR、LTSR、CR EAR、またはLTSR EAR）が選択されていません。
スケジュール済み	UpgradeScheduled	VDAのアップグレードがスケジュールされています。
利用可能	UpgradeAvailable	VDAはアップグレードトラックの最新バージョンではありません。アップグレードが推奨されます。
最新	UpToDate	VDAはアップグレードトラックの最新バージョンです。アクションは不要です。
状態を確認中	不明	最新のVDAアップグレード状態を取得しています。

注:

LTSRトラックを使用しているVDAの場合、カタログは、VDAが最新の長期サービスリリース (LTSR) バージョンの最新累積更新プログラム (CU) にある場合にのみ「最新」と表示されます。VDAが以前のLTSRバージョンの最新CUにある場合でも、VDAアップグレードは引き続き「利用可能」と表示されます。

VDAアップグレードの状態

VDA Upgrade Stateは、スケジュールされたアップグレードのステータスに関する情報を提供します。VDAアップグレードの状態のステータスは次のとおりです。

VDAアップグレードの状態 (Studio)	VDAアップグレードの状態 (PowerShell)	説明
カタログレベル
スケジュールされていません	NotScheduled	カタログのアップグレードはスケジュールされていません。
スケジュール済み	UpgradeScheduled	カタログのアップグレードがスケジュールされています。
進行中	UpgradeInProgress	カタログのアップグレードが進行中です。
キャンセル済み	アップグレードがキャンセルされました	カタログのアップグレードがキャンセルされました。これは、手動によるキャンセル、または失敗しきい値に達したことが原因である可能性があります。
失敗	アップグレード失敗	カタログのスケジュールされたアップグレードが失敗しました。
成功	アップグレード成功	カタログのスケジュールされたアップグレードが正常に完了しました。注：アップグレードが成功したからといって、カタログ内のすべてのVDAが正常にアップグレードされたわけではありません。
-	空	カタログのアップグレードはスケジュールされていません。
マシンレベル
スケジュール済み	アップグレードがスケジュールされました	VDAのアップグレードがスケジュールされています。
アップグレード待機中	UpgradeInUpgradeWindow	スケジュールされたアップグレードはアクティブですが、VDAはまだアップグレードを開始していません。VDAアップグレードがどのように負荷分散されるかについては、「同時実行」を参照してください。
進行中	UpgradeInProgress	VDAは現在アップグレード中です。
キャンセル済み	UpgradeCancelled	アップグレードが開始される前に、VDAのスケジュールされたアップグレードがキャンセルされました。
アップグレード失敗	UpgradeFailed	VDAはアップグレードを開始しましたが、アップグレードが正常に完了しませんでした。詳細については、「トラブルシューティング」を参照してください。
成功	UpgradeSuccess	VDAは正常にアップグレードされました。
検証に失敗しました	UpgradeValidationFailed	VDAインストーラーのメタデータをダウンロード中に、証明書の検証に失敗しました。
-	空	VDAのアップグレードはスケジュールされていません。

スケジュールされたVDAアップグレードのトラブルシューティング

アップグレードの失敗が発生した場合、以下のログは問題の特定とトラブルシューティングに役立ちます。これらのログをCitrixテクニカルサポートと共有することで、サポートプロセスを迅速化することもできます。

VDAインストールログ

アップグレードの失敗をトラブルシューティングする際は、VDAの初回インストールと失敗したアップグレードの両方のログを収集して確認してください。インストールおよびアップグレードのログは、以下の場所にあります。

VDAインストールのインストールログは、次の場所にあります。
- %temp%/Citrix/XenDesktop インストーラー
VDAインストールのアップグレードログは、次のいずれかの場所にあります。
- C:\Windows\Temp\Citrix\XenDesktop Installer または
- C:\Windows\SystemTemp\Citrix\XenDesktop インストーラー

VDAアップグレードエージェントのバージョン

VUSを介してアップグレードの失敗をトラブルシューティングするためのデータを収集する際、VDA上のアップグレードエージェントのバージョンを知ることが重要です。VDAアップグレードエージェントのバージョンを確認するには、次のコマンドレットを使用します: Get-VusComponentVersion -ComponentType VUS。これにより、すべてのVDAとそのVDAアップグレードエージェントのバージョンが一覧表示されます。

カタログレベルでVDAアップグレードエージェントのバージョンを確認するには、次のスクリプトを使用できます。

注:

このスクリプトは例として提供されており、特定の環境に合わせて調整する必要がある場合があります。本番環境で使用する前に、スクリプトを十分にテストすることをお勧めします。

Param( [Parameter (Mandatory=$true)] [string] $CatalogName ) try { $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID

if($Uuids -eq $null) { throw "Cannot find CatalogName " +$CatalogName } Write-Output("Catalog Name passed is "+$CatalogName)

foreach($Uuid in $Uuids) { $compVersion = Get-VusComponentVersion -MachineId $machine.UUID -ComponentType VUS $Machine = Get-BrokerMachine -UUID $compVersion.MachineId Write-Output(“MachineName: “+$Machine.MachineName+”, Machine UUID:”+$machine.MachineId+”, VUA Version:”+$compVersion.Version) } } catch { Write-Output(“Exception Occured”) Write-Host $_ }

VDAアップグレードエージェントに関連するログ

VDAアップグレードエージェント (VUA) のログは、アップグレードの失敗や、VUAとVDAアップグレードサービス間の通信に関する問題のトラブルシューティングに不可欠な情報を提供できます。収集できるログには、次のものがあります。

Citrix Diagnostic Facility (CDF) トレース。CDFモジュール名はVdaUpgradeAgentです。
Windowsイベントログ。イベントビューアー > Windowsログ > アプリケーション > Citrix VDA Upgrade Agent Service でログを表示します。

VUAバージョン7.44以降の場合

VDAアップグレードサービスエージェントバージョン7.44（2503リリースに含まれる）では、管理者がトラブルシューティングのための重要な情報をキャプチャしつつ、ログファイルが大きくなりすぎるのを防ぐローテーションログファイルを有効にできるレジストリ設定が利用可能です。ログファイルの合計サイズは20 MBに制限されています。ファイルへのログ記録を有効にするには、次のレジストリキーを作成します。

キー:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force
値の名前: LogToFile
値の型: REG_DWORD
値のデータ:
- 0 - ファイルトレース無効
- 1 - ファイルトレース有効

PowerShell を使用して VDA 上に LogToFile レジストリキーを作成するには、次のコマンドレットを使用します。

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force

大規模なマシン群に対して LogToFile を有効にするには、グループポリシー設定を通じてすべての VDA 組織単位 (OU) に LogToFile レジストリを作成することを検討してください。

注:

LogToFile=1 が設定されている場合、ログはファイルにのみ書き込まれます。CDF トレースには表示されません。

レジストリの変更を有効にするには、VDA アップグレードエージェントサービスを再起動する必要があります。

ログファイルは C:\ProgramData\Citrix\Update Services\Logs フォルダーに作成されます。

VUA バージョン 7.43 以前の場合

必要に応じて、VDA アップグレードエージェントの構成ファイルを変更して、ログが継続的にファイルに書き込まれるようにすることができます。ファイルへのログ記録を有効にするには、次の手順に従います。

フォルダー C:\Program Files\Citrix\CitrixUpgradeAgent に移動します。
ファイル Citrix.UpdateServices.UpdateAgent.exe.config を開きます。
LogToFile の値を 1 に変更します。
Citrix VDA Upgrade Agent サービスを再起動します。これにより、ログファイルが次の場所に作成されます: C:\ProgramData\Citrix\Update Services\Logs。

注:

.config ファイルを介してファイルへのログ記録を有効にすると、ログが継続的に書き込まれ、ストレージ領域を消費する可能性があります。問題が解決したら、ログ記録を無効にすることを忘れないでください。ログ記録を無効にするには、まず LogToFile を 0 に設定してから、Citrix VDA Upgrade Agent サービスを再起動します。

LogToFile=1 が設定されている場合、ログはファイルにのみ書き込まれます。CDF トレースには表示されません。

VDA アップグレードのダウンロード失敗のトラブルシューティング

以下の手順に従って、VDA アップグレード機能に関連するダウンロードの失敗をトラブルシューティングし、解決します:

URL フィルタリングが有効になっている場合は、関連する URL が許可リストに追加されていることを確認してください。VDA アップグレードの要件を参照してください。
必要な URL を許可リストに追加した後、VDA アップグレードの再スケジュールを試してください。

CDF トレースを有効にするか、LogToFile を 1 に設定して、分析用の詳細なログをキャプチャできます。ダウンロードの失敗の問題が解決しない場合は、エラーを確認してください。「Download Failed: This access control list is not in canonical form and therefore cannot be modified」というエラーメッセージが表示される場合、フォルダー C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA のアクセス許可が正しくないことを示しています。

この問題に対処するには、次のいずれかを実行します:

オプション 1: 次のコマンドを使用して、フォルダーのアクセス制御リスト (ACL) をリセットします。(このコマンドは、一致するすべてのファイルに対して、デフォルトで継承された ACL で ACL をリセットします。)
- icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
オプション2: ダウンロードの下にあるVDAフォルダーを削除してから、VDAアップグレードをスケジュールします。

VDAアップグレード検証の失敗のトラブルシューティング

VDAアップグレード機能に関連するダウンロードの失敗をトラブルシューティングして解決するには、以下の手順に従ってください。

URLフィルタリングが有効になっている場合は、関連するURLが許可リストに追加されていることを確認してください。特に、失効チェックに必要な証明書失効リスト（CRL）またはオンライン証明書ステータスプロトコル（OCSP）のURLが重要です。VDAアップグレードの要件を参照してください。
必要なURLを許可リストに追加した後、VDAアップグレードの再スケジュールを試してください。

分析のために詳細なログをキャプチャするには、CDFトレースを有効にするか、LogToFileを1に設定することをお勧めします。ログには以下のエラーが含まれる場合があります。

RevocationStatusUnknown
失効機能は、証明書の失効ステータスを確認できませんでした。
失効サーバーがオフラインだったため、失効機能は失効を確認できませんでした。

VDAアップグレードエージェントは、証明書を検証し、失効チェックを実行するためにWindowsシステムコールに依存しています。上記のエラーは、エージェントがCRLまたはOCSPのURLへの接続を確立できないことを示しています。

Windows CryptoAPIは現在、プロキシ設定をサポートしていません。アウトバウンドCRL呼び出しを容易にするためのVDAプロキシの構成については、「プロキシ構成を持つVDA」セクションを確認してください。

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

監視とトラブルシューティング

September 3, 2026

寄稿者:

C C

September 3, 2026

寄稿者:

C C

この情報は役に立ちましたか?