Citrix トラブルシューティング接続

最終公開日 : Oct 24, 2026
Citrix トラブルシューティング接続機能は、エンドユーザーがデスクトップまたはアプリケーションの起動失敗の可能性を効果的に自己トラブルシューティングできるように設計されています。この機能強化は、ユーザーに明確な診断、潜在的な推奨事項、および簡単なクリックで修正を実行する機能を提供することを目的としています。
Related information
管理

概要

Citrix は、起動失敗の根本原因をユーザーが明確に理解できるように、より詳細で強化されたエラーメッセージを提供するようになりました。トラブルシューティング接続機能は、起動プロセス中にVirtual Delivery Agent (VDA) への到達可能性に関する課題をリアルタイムで分析します。その後、ユーザーフレンドリーなエラーメッセージと推奨事項を提示し、ユーザーが問題を直接解決するか、必要に応じてサポートチケットのためにログを収集できるようにします。

分析された接続パス

この機能は、以下を含む重要な接続ポイント全体で、仮想アプリとデスクトップの起動に関する潜在的な問題を診断します。
  • クライアントからゲートウェイへのネットワーク接続。
  • ゲートウェイからStoreFrontサーバーへの接続。
  • StoreFrontサーバーからBrokerへの接続。
  • BrokerからVDAへの接続。

強化されたエラーメッセージと診断

起動失敗が発生した場合、Citrix は、ネットワークエラー、サーバーの利用不可、VDA障害など、特定の接続問題を特定する明確でユーザーフレンドリーなエラーメッセージを表示するようになりました。管理者向けには、ログに詳細なエラーコードが提供され、サーバー側エラーとクライアント側エラーに分類されており、より詳細な調査のための貴重な参照として機能します。

自己回復と修復アクション

Citrix トラブルシューティング接続機能には、ユーザーが一般的な問題から自動的に回復するための手順が含まれており、サポート介入の必要性を最小限に抑えます。以下は、ガイド付き修復で解決できる潜在的な問題です。
  • VDAの再起動
  • Citrix Workspaceアプリ (CWA) を再起動する - CWA に再ログインする
  • リソースリストを更新する
  • アプリを更新して試す
  • ストアを再構成する
  • CWA をアップグレードする
  • CWA を再インストールする
  • ネットワークを確認する
  • 待ってから再試行する

システム要件

接続トラブルシューティング機能を使用するには、以下の Citrix Workspace アプリのバージョンが必要です。
  • Mac 用 Citrix Workspace アプリ: バージョン 2505 以降
  • Windows 用 Citrix Workspace アプリ: バージョン 2507 以降
  • iOS 用 Citrix Workspace アプリ: バージョン 2509 以降
  • Android 用 Citrix Workspace アプリ: バージョン 2509 以降

使用方法

接続トラブルシューティング機能は、Citrix DaaS環境でデフォルトで有効になっています。詳細で強化されたエラーメッセージと、修正の推奨事項が、ブラウザから起動されたセッションと、ネイティブのCitrix Workspaceアプリを介して直接起動されたセッションの両方に提供されます。

重要な考慮事項

この機能は堅牢なセルフサービス機能を提供しますが、以下の点に注意することが重要です。
  • 「VDAの再起動」修正アクションは、ハイブリッド起動モード（つまり、ブラウザからICAファイルをダウンロードし、ネイティブのCitrix Workspaceアプリで起動するモード）で起動されたセッションはサポートしていません。

エラーコード

エラーコードは、サーバー側エラーとクライアント側エラーに分かれています。以下にエラーコードの表を示します。

一般的なサーバー側エラー

エラーID 説明 推奨事項
ResourceNotFound リソースは管理者によって削除されました。 利用可能なアプリとデスクトップの最新リストについては、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
WorkstationInMaintenance デスクトップは計画メンテナンス中です。 メンテナンスが完了するまで待ってから、もう一度試してください。
UnavailableDesktop 接続できるデスクトップがありません。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者にお問い合わせください。
UnavailableAppProtectedDesktop 保護されたリソースを開くには、App Protectionが必要です。 App Protectionを搭載したCitrix Workspaceアプリのバージョンにアップグレードするか、システム管理者に連絡してサポートを受けてください。
NotLicensed サーバーに適切なライセンスがないため、リソースを起動できません。 システム管理者に連絡してサポートを受けてください。
NoMoreActiveSessions 利用可能なセッションスロットがないため、リソースを起動できません。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者にお問い合わせください。
GeneralAppLaunchError リソースを開こうとしたときに不明なエラーが発生しました。 システム管理者に連絡して支援を求めてください。
ResourceDisabled 管理者がリソースを無効にしました。 利用可能なアプリとデスクトップの最新リストを表示するには、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。

Windows向けCitrix Workspaceアプリ

エラーID 説明 推奨事項
CertificateError サーバー証明書でエラーが発生しました。 システム管理者に連絡して支援を求めてください。
PassthroughClientError アクティブなセッションが既に存在します。 システム管理者に連絡して支援を求めてください。
IcaFileRetrieveError ICAファイルの取得中にエラーが発生しました。 システム管理者に連絡して支援を求めてください。
Icafileretrieveerrorreconnection 再接続中にICAファイルの取得中にエラーが発生しました。 システム管理者に連絡して支援を求めてください。
NoCWA リソースを開くにはCitrix Workspaceアプリが必要です。 Citrix Workspaceアプリをインストールするか、システム管理者に連絡して支援を求めてください。
CouldNotFindStore リソースを起動するために必要なストア構成を取得できません。 Citrix Workspaceアプリからストアを削除し、再度追加してください。問題が解決しない場合は、システム管理者に連絡してください。
noclientinstalled リソースを起動するために必要な情報を取得できません。 Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
AuthCancelled 認証セッションの有効期限が切れました。 問題を解決するには、Citrix Workspaceアプリで再認証してください。問題が解決しない場合は、システム管理者に連絡してください。
IcaFileLaunchError ICAファイルの起動中にエラーが発生しました。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CouldNotContactStore VDAとの通信中にエラーが発生しました。これはサーバー接続の問題が原因である可能性があります。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CCMError Connection Managerエラーのため、リソースを起動できません。エラーコード: {errorCodeValue} Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CCMInitFailed Connection Managerの初期化に失敗したため、リソースを起動できません。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CCMLoadFailed Connection Manager の読み込みに失敗したため、リソースを起動できません。 Citrix Workspace アプリを終了して再起動してください。問題が解決しない場合は、システム管理者に問い合わせてください。
InvalidIcaParams ICA パラメーターが正しくないため、リソースを起動できません。 Citrix Workspace アプリを終了して再起動してください。問題が解決しない場合は、システム管理者に問い合わせてください。
AppExiting Citrix Workspace アプリが終了中のため、リソースを起動できません。 Citrix Workspace アプリを終了して再起動してください。問題が解決しない場合は、システム管理者に問い合わせてください。
UTF8ConversionFailed ICA ファイルを解析できません。 Citrix Workspace アプリを終了して再起動してください。問題が解決しない場合は、システム管理者に問い合わせてください。
MissingSoftware このアプリを使用するには、追加のソフトウェアが必要です。 システム管理者に問い合わせて支援を受けてください。

Mac 用 Citrix Workspace アプリ

エラーID 説明 推奨事項
AuthCancelled 認証セッションの有効期限が切れました。 問題を解決するには、まず資格情報で認証してください。問題が解決しない場合は、システム管理者に連絡してください。
NetworkError ネットワーク接続の問題により、リソースを起動できません。 接続を確認して、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerNotFound Citrix Viewer のパスが見つかりません。 問題を解決するには、Citrix Workspace アプリをアンインストールして再インストールしてください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerOpenEventFailed Citrix Viewer がイベントの作成に失敗しました。 ストアからリソースをもう一度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerLaunchTimeout Citrix Viewer の起動がタイムアウトしました。 ストアからリソースを再度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerLaunchFailure Citrix Viewer の起動に失敗しました。 ストアからリソースを再度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
InvalidICAFile ICA ファイルが無効なため、リソースを起動できません。 ストアからリソースを再度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
CertificateError サーバー証明書でエラーが発生しました。 システム管理者に連絡して支援を求めてください。
ResourceError リソースの起動中にエラーが発生しました。これはサーバー接続の問題が原因である可能性があります。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。
UnknownError リソースを開こうとしたときに不明なエラーが発生しました。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者にお問い合わせください。

iOS版Citrix Workspaceアプリ

エラーID 説明 推奨事項
credentialsMustChange パスワードを変更する必要があります。 アカウント設定に移動してパスワードを変更してください。問題が解決しない場合は、システム管理者にお問い合わせください。
noConfigurationFile 必要な構成データを取得できません。 問題を解決するには、Citrix Workspaceアプリからストアを削除し、再度追加してください。問題が解決しない場合は、システム管理者にお問い合わせください。
http404Error リソースが利用できません。 システム管理者に連絡して支援を求めてください。
invalidTransactionId 無効なトランザクションIDです。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者にお問い合わせください。
credentialsExpired パスワードの有効期限が切れました。 アカウント設定に移動してパスワードを変更してください。問題が解決しない場合は、システム管理者にお問い合わせください。
badAddressError リソースアドレスが見つかりません。 接続を確認して、もう一度お試しください。問題が解決しない場合は、システム管理者にお問い合わせください。
accountDisabled アカウントが無効になっています。 システム管理者に連絡して支援を求めてください。
accountLockedOut アカウントは一時的にロックされています。 システム管理者に連絡して支援を求めてください。
storeServerConnectionError サーバーとの通信中にエラーが発生しました。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。
internalServerError サーバーへの接続中に不明なエラーが発生しました。 システム管理者に連絡して支援を求めてください。
invalidXML XMLサービスからのエラーにより、リソースを開くことができません。 システム管理者に連絡して支援を求めてください。
badCredentials 資格情報が期限切れになりました。 問題を解決するには、Citrix Workspaceアプリからログアウトし、再度ログインしてください。問題が解決しない場合は、システム管理者に連絡してください。
appRemoved リソースは管理者によって削除または無効化されました。 利用可能なアプリとデスクトップの最新リストについては、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
invalidLogonHours 管理者によって設定された制限のため、現在ログインできません。 通常の勤務時間中にもう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。
connectionError サーバーに接続できません。これはネットワーク接続の問題が原因である可能性があります。 問題を解決するには、Citrix Workspaceアプリを終了して再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。

Android版Citrix Workspaceアプリ

エラーID 説明 推奨事項
http404Error ネットワーク接続の問題により、リソースを起動できません。 接続を確認して、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。
couldNotConnectToWorkstation デスクトップに接続できません。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
retryReasonRebooting リソースの起動中にエラーが発生しました。要求されたワークステーションは再起動中です。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
retryReasonResuming リソースの起動中にエラーが発生しました。要求されたワークステーションは再開中です。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
generalProblem リソースを開こうとしているときに問題が発生しました。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
retryReasonUnknown ICAファイルでエラーが発生しました。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
appRemoved リソースは管理者によって削除または無効にされました。 利用可能なアプリとデスクトップの最新リストについては、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
resourceError ICAファイルの起動中にエラーが発生しました。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。専用マシンである場合は、VDAを再起動してください。
resourceUnavailable ICAファイルの起動中にエラーが発生しました。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。専用マシンである場合は、VDAを再起動してください。