製品ドキュメント
Citrix DaaS™
PDFを表示

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

May 4, 2026
寄稿者: 
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でログを表示します。

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 を有効にするには、グループポリシー設定 (Group Policy Preference) を通じて、すべての VDA 組織単位 (OU) に LogToFile レジストリを作成することを検討してください。

注:

  • LogToFile=1 が設定されている場合、ログはファイルにのみ書き込まれます。CDF トレースには表示されません。
  • レジストリの変更を有効にするには、VDA アップグレードエージェントサービスの再起動が必要です。
  • ログファイルは C:\ProgramData\Citrix\Update Services\Logs フォルダーに作成されます。

VUA バージョン 7.43 より前の場合

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

  1. C:\Program Files\Citrix\CitrixUpgradeAgent フォルダーに移動します。
  2. Citrix.UpdateServices.UpdateAgent.exe.config ファイルを開きます。
  3. LogToFile の値を 1 に変更します。
  4. Citrix VDA アップグレードエージェントサービスを再起動します。これにより、C:\ProgramData\Citrix\Update Services\Logs にログファイルが作成されます。

注:

  • .config ファイルを介してファイルへのログ記録を有効にすると、ログが継続的に書き込まれ、ストレージ容量を消費する可能性があります。問題が解決したら、ログ記録を無効にすることを忘れないでください。ログ記録を無効にするには、まず LogToFile を 0 に設定し、Citrix VDA アップグレードエージェントサービスを再起動します。
  • LogToFile=1 が設定されている場合、ログはファイルにのみ書き込まれます。CDF トレースには表示されません。

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

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

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

  2. 必要な 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 アップグレード機能に関連するダウンロードの失敗をトラブルシューティングして解決するには、以下の手順に従います。

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

  2. 必要な URL を許可リストに追加した後、VDA アップグレードの再スケジュールを試行してください。

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

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

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

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

監視とトラブルシューティング
May 4, 2026
寄稿者: 
C
May 4, 2026
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.