執行 Bot agent診斷檢查

使用 Bot agent診斷公用程式處理 Bot Runner 裝置與 Control Room 之間的連線相關問題。此公用程式提供解決方案或建議來協助診斷問題，以進一步解決問題。

1. 開啟 Windows 命令提示字元。
2. 瀏覽至 Bot agent 安裝路徑。
   • Bot agent安裝在系統層級的預設路徑為 C:\Program Files\Automation Anywhere\Bot Agent。
   • Bot agent安裝在本機使用者層級的預設路徑為 %USERPROFILE%\AppData\Local\Programs\Automation Anywhere\Bot Agent。
3. 輸入 AADiagnosticUtility.exe 以執行 Bot agent診斷公用程式。
   執行診斷檢查的各種選項會連同其說明一起顯示。

   選項	說明
   -checkDownloadError <CR_URL>	如果bot部署失敗，請檢查bot相依性是否下載錯誤。 註: 錯誤訊息會保留在裝置記憶體中，並在 Bot agent服務重新啟動時移除。 當 Bot Runner 裝置連線至 Control Room，但自動化因為相依套件並未下載至 Bot Runner 裝置而失敗時，請使用此選項。在此案例中，公用程式會提供進一步診斷的建議。
   -checkProxy <CR_URL>	檢查裝置上的 Proxy 設定。 當 Bot Runner 裝置無法連線至 Control Room 時，請使用此選項來確認 Proxy 是否可用，或已為 Bot agent設定以供使用。 您也可以選擇使用 importProxy 選項匯入 Proxy 設定。
   -checkWSError <CR_URL>	檢查 WebSocket 連線和錯誤。 註: 錯誤訊息會保留在裝置記憶體中，並在 Bot agent服務從 Windows 工作管理員的 [服務] 分頁重新啟動時移除。 Bot Runner 裝置由於 WebSocket 連線錯誤而無法連線至 Control Room 時，此選項能提供進一步調查的可能原因。
   -collectlogs	從 Bot Runner 裝置擷取多個記錄，以縮短收集問題相關資訊的處理時間。 使用此選項以擷取並儲存目前日期節點管理員、bot啟動器和事件檢視器記錄，以在執行公用程式的裝置上，對壓縮的資料夾進行除錯和疑難排解。 對於安裝在系統層級的 Bot agent，記錄會儲存在 C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip 對於安裝在本機使用者層級的 Bot agent，記錄會儲存在 %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip Recommendation: 若要擷取安全性事件的 Windows 記錄，請以更高的權限執行公用程式 (以管理員身分執行)。 如果您在沒有提高權限的情況下執行公用程式，則會顯示下列錯誤： 錯誤：無法擷取 security_event_viewer_<date>.evtx 若要節省儲存空間，請在除錯後刪除檔案。
   -configProxy <CR_URL>	檢查 Proxy 組態，並視需要設定 Proxy 認證。 當 Bot Runner 裝置因為缺少驗證伺服器的認證而無法連線至 Control Room 時，請使用此選項來設定 Proxy 伺服器認證。登入 Control Room 以確認連線問題已解決。
   -importProxy <CR_URL>	將已登入使用者裝置的 Proxy 設定匯入至系統使用者裝置。 註: 您必須有管理員權限才能匯入 Proxy 設定。 Bot Runner 裝置由於 Proxy 伺服器問題而無法連線至 Control Room 時，請使用此選項將已登入使用者的 Proxy 設定匯入至 Bot agent的系統使用者。 此選項會提供下列資訊： Proxy 伺服器是否經過驗證。 Control Room URL 會新增至 Proxy 伺服器中的安全收件者清單。 WebSocket 連線可作為 Proxy 組態的一部分。
   -importSSLCertificate path_to_ssl_certificate	如有需要，請將 SSL 憑證匯入 Java 認證存放區。 註: 您必須有管理員權限才能匯入 SSL 憑證。 當 Bot Runner 裝置因為無效的 SSL 憑證而無法連線至 Control Room 時，請使用此選項匯入 SSL 憑證。您必須確保在 importSSLCertificatepath_to_ssl_certificate 選項中指定的檔案位置可以使用有效的憑證檔案。 您必須重新啟動 Automation Anywhere Bot agent服務，以使匯入的憑證生效。
   -list	在本機裝置上檢視作用中的bot部署。 使用此選項可檢查並列出正在執行的自動化 (bots)。
   -ping <CR_URL>	檢查 Control Room 和 Bot Runner 裝置之間的連線。 使用此選項可檢查 Bot Runner 裝置是否可以 Ping (觸及) Control Room。
   -validateSSLCertificate <CR_URL>	檢查有效的 SSL 憑證，並檢視憑證是否有效或無效。 註: 您必須具有讀取權限才能執行此檢查。 當 Bot Runner 裝置因為無效的 SSL 憑證而無法連線至 Control Room 時，請使用此選項來檢查並檢視 SSL 憑證是否有效。若要解決此問題，請使用 importSSLCertificate 選項。

4. 在命令提示字元下輸入以下選項： <filepath>\AADiagnosticUtility.exe -<option> <CR_URL>
   例如，若要確認 WebSocket 錯誤，請在命令提示字元中輸入下列內容： AADiagnosticUtility.exe -checkWSError https://yourcrurl.com/
   選項會傳回下列結果：最近此裝置並未發生任何 Web 通訊端錯誤

   使用其他選項執行進一步的診斷檢查。