製品ドキュメント

Citrix Virtual Apps and Desktops

PDFを表示

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

April 6, 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) が選択されていません。
スケジュール済み	UpgradeScheduled	マシンカタログのアップグレードがスケジュールされています。
利用可能	UpgradeAvailable	カタログ内のVDAは、アップグレードトラックの最新バージョンではありません。アップグレードが推奨されます。
最新	UpToDate	カタログ内のVDAは、アップグレードトラックの最新バージョンです。アクションは不要です。
不明	Unknown	最新のVDAアップグレード状態を取得しています。
マシンレベル
未構成	MissingUpgradeType	VDAのマシンカタログのアップグレードトラック (CR、LTSR、CR EAR、またはLTSR EAR) が選択されていません。
スケジュール済み	UpgradeScheduled	VDAのアップグレードがスケジュールされています。
利用可能	UpgradeAvailable	VDAは、アップグレードトラックの最新バージョンではありません。アップグレードが推奨されます。
最新	UpToDate	VDAは、アップグレードトラックの最新バージョンです。アクションは不要です。
状態を確認中	Unknown	最新のVDAアップグレード状態を取得しています。

注:

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

VDAアップグレードの状態

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

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

-  |進行中|UpgradeInProgress|VDAは現在アップグレード中です。|
-  |キャンセル済み|UpgradeCancelled|アップグレードが開始される前に、VDAのスケジュールされたアップグレードがキャンセルされました。|
-  |アップグレード失敗|UpgradeFailed|VDAはアップグレードを開始しましたが、アップグレードは正常に完了しませんでした。詳細については、「トラブルシューティング」を参照してください。|
-  |成功|UpgradeSuccess|VDAは正常にアップグレードされました。|
-  |検証失敗|UpgradeValidationFailed|VDAインストーラーのメタデータをダウンロード中に証明書の検証に失敗しました。| |-|Empty|VDAのアップグレードはスケジュールされていません。|

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

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

VDAインストールログ

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

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

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 で表示します。
管理者が、トラブルシューティングに不可欠な情報をキャプチャしつつ、ログファイルが大きくなりすぎるのを防ぐローテーションログファイルを有効にできるレジストリ設定が利用可能です。ログファイルの合計サイズは20 MBに制限されます。ファイルへのログ記録を有効にするには、次のレジストリキーを作成します。
キー: HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile
値の名前: LogToFile
値の型: REG_DWORD
値のデータ:
- 0 - ファイルトレース無効
- 1 - ファイルトレース有効

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

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

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

注:

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

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

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

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

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

URLフィルタリングが有効な場合は、関連するURLが許可リストに追加されていることを確認してください。接続性を参照してください。
必要な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: Downloadsの下にある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ドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

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

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

April 6, 2026

寄稿者:

C C

April 6, 2026

寄稿者:

C C

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