Patch Manager Plus Cloud ナレッジベース

エージェントのトラブルシューティングツールの使用方法


この記事では、Patch Manager Plus Cloudのエージェントで利用可能なトラブルシューティングツールについて説明しています。

トラブルシューティングツールの使用方法

Windowsエージェントのトラブルシューティングツール

Patch Manager Plus Cloudと各エージェントとの間で何らかの原因により通信に失敗している場合、トラブルシューティングツールを実行することで、原因を切り分けることができます。

  1. エージェントがインストールされているWindowsコンピューター右下のタスクトレイをクリックし、以下スクリーンショットPatch Manager Plusエージェントのトレイアイコンを右クリックします。

    その他の実行方法

    • トレイアイコンを表示させていない場合、実行可能ファイルを管理者権限で直接実行します。
      <エージェントフォルダー>\bin\agent_troubleshooting_tool.exeを管理者として実行することでも、トラブルシューティングツールを実行可能です。
      なお、エージェントが最新版にアップグレードされていない場合、トラブルシューティングは実行できません。実行しても表示されない場合は、エージェントのバージョンをご確認ください。
    • トレイアイコンが表示されていない場合は、エージェントトレイアイコンの設定を変更します。
      [エージェント]タブ →[設定]→ [エージェント設定]→[エージェントトレイアイコン]タブ →「エージェントアイコンをシステムトレイに表示する」にチェックを入れると、90分以内に設定がエージェントに反映されます。
      なお、「エージェントアイコンをシステムトレイに表示させる」以外の各項目のチェックは任意です。
  2. 下の方の「Agent Troubleshoot」→「トラブルシューティング」をクリックします。
  3. トラブルシューティングツールの画面が表示されたら、「トラブルシューティングを開始する」(Start Troubleshooting)ボタンをクリックします。
  4. 結果が出るまでしばらく待ちます。
     
  5. 以下のような結果が表示されます。(赤く表示されている項目で、問題が起こっている可能性があります。ただし、Antivirusはトラブルシューティングツールの仕様上、例外設定が正しく完了しているか判定が困難なため、正しく設定されている場合でも注意表示になることがあります。)
  6. 画面右上より「トラブルシューティングサマリー」を選択し、詳細を確認します。

     
  7. サポートより依頼された場合などは、必要に応じて画面右上より「エクスポート」をクリックし、トラブルシューティングツールの実行結果をエクスポートします。

Macエージェントのトラブルシューティングツール

2026年2~3月のアップデートにおいて、macOSエージェントにトラブルシューティングツールが実装されました。

  1. 通知領域アイコンをクリックし、「Troubleshoot」→「Run Troubleshooting tool」を選択します。
  2. ターミナルに結果が表示されます。

Linuxエージェントのトラブルシューティングツール
  1. ターミナルでエージェントディレクトリ/binにアクセスします。

    cd /usr/local/manageengine/uems_agent/bin

  2. dctroubleshootingtoolスクリプトを実行します。

    sudo ./dctroubleshootingtool

  3. 結果が表示されます。

 

結果の確認方法

トラブルシューティングツールを実行し、Homeタブの結果を確認します。

  • Patch Manager Plus サーバー
    Patch Manager Plus CloudのURLおよびポート番号(443)が表示され、通信の確認結果が表示されます。正常であれば緑色のチェックマークが表示されます。
    接続に失敗(Failed)となった場合は、ファイアウォールやプロキシにおいて、Patch Manager Plus Cloudとの通信がブロックされていないか確認します。加えて、Patch Manager Plus Cloudの可用性を確認します。
     
  • Notification Server:
    Patch Manager Plus Cloudのうち、エージェントへのプッシュ操作を命令する通知(Notification Server, dms.zoho.**)との通信の確認結果が表示されます。正常であれば緑色のチェックマークが表示されます。
    接続に失敗(Failed)となった場合は、ファイアウォールやプロキシにおいて、Patch Manager Plus Cloudとの通信がブロックされていないか確認します。Patch Manager Plus Cloudの可用性を確認します。
     
  • エージェントサービス:
    Patch Manager Plusエージェントのコンポーネントは、Windowsサービスとして稼働します。各コンポーネントの稼働状況を確認します。
     
  • エージェントの同一性:
    当該コンピューターの固有情報を取得します。
    失敗する場合はWMIサービスが稼働していない可能性があります。WMIサービスのステータスを確認します。
     
  • エージェントバイナリ:
    Patch Manager Plusエージェントの各機能の稼働状況を表示します。
     
  • WMI:
    当該コンピューターにおいて、WMIサービスが稼働しているか確認結果が表示されます。Patch Manager PlusエージェントはWMIサービスを使用して一部のパッチ情報を把握するため、管理対象PCにおいてWMIサービスが稼働している必要があります。
    接続に失敗(Failed)となった場合は、Endpoint Centralオンプレミス版のナレッジ インベントリスキャンの失敗 – 資産スキャンがロックされる/WMI接続が失敗する を確認します。
     
  • Active Directory:
    ADドメイン環境の場合、ステータスが正常であれば、当該ユーザー/コンピューターが含まれるOUやグループの一覧を取得します(Workgroup環境の場合、この項目はスキップされます)。
    接続に失敗(Failed)となった場合は、AD Connectorに指定した配信サーバーからドメインコントローラーに到達可能かを確認します。
     
  • アンチウイルス:
    アンチウイルスソフトのスキャン対象からPatch Manager Plusエージェントフォルダーを除外するよう、注意マークが表示されます。
    失敗(Failed)となった場合は、アンチウイルスソフトの除外登録についてを確認します。