项目作者: johnduprey
项目描述 :
ConnectWise Control - Automate Diagnostics Extension
高级语言: PowerShell
项目地址: git://github.com/johnduprey/CWCAutomateDiagnostics.git
CWCAutomateDiagnostics
Run ConnectWise Automate agent diagnostics from ConnectWise Control. This extension utilizes the Labtech-Powershell-Module to review CWA agent settings and service statuses. The extension will also perform automatic service repairs and updates.

Features
- NEW - LTErrors.txt / agent.log file is returned in the diagnostic
- NEW - /usr/local/ltechagent/ltupdate initiated from AutomateDiagnostics.py
- Maintenance Mode - Disable diagnostics on GuestConnect event
- Mac OS X/Linux Agent Reporting
- Forces agent updates using Update-LTService
- Verifies LTService and LTSVCmon services are running and set to Automatic. Will start services and set StartMode to Automatic.
- Verifies checkin and heartbeat times.
- Stores the CWA Agent ID as CustomProperty6 (customizable).
- Stores the CWA Version as CustomProperty7 (customizable).
- Provides custom Session Group that sorts endpoints by CWA version number.
- Repair option now uses InstallerToken, generate a long lived one using this script https://www.mspgeek.com/files/file/50-generate-agent-installertoken/.
Installation
- Install Automate Diagnostics from the ConnectWise Control Marketplace (version 1.0.6.7)
Manual Instructions
To install this version, 1.0.7.2:
- Create a new directory for the extension - %programfiles(x86)%\ScreenConnect\App_Extensions\e4dd11eb-3c5e-407c-a7b8-a8ea5e6dbb76
- Download the lastest master.zip and extract all files into the directory
- Enable the extension in the administration page.
Setup
- In the settings, modify the PathToLTPoSh to a URL that you trust or one that is configured to bypass content filters
- Additionally, find the Guid for the Control extension (manual one is listed above, cloud is 26a42e0d-6233-4a66-9575-6e05a248cd26)
- Build the URL with the extension Guid and add that to the settings to avoid calling the script from GitHub. (e.g https://control_url:port/App_Extensions//AutomateDiagnostics.ps1)
- Edit the Control web.config file (make a backup first): Under the
<httpHandlers>
section, add verb entries for each script file:
<add verb="GET,HEAD" path="App_Extensions/e4dd11eb-3c5e-407c-a7b8-a8ea5e6dbb76/AutomateDiagnostics.ps1" type="System.Web.DefaultHttpHandler" ></add>
<add verb="GET,HEAD" path="App_Extensions/e4dd11eb-3c5e-407c-a7b8-a8ea5e6dbb76/AutomateDiagnostics.py" type="System.Web.DefaultHttpHandler" ></add>
<add verb="GET,HEAD" path="App_Extensions/e4dd11eb-3c5e-407c-a7b8-a8ea5e6dbb76/AutomateDiagnostics.sh" type="System.Web.DefaultHttpHandler" ></add>
Usage
- Script is automatically executed on GuestConnect event (e.g. Service/Computer reboot). RanCommand events are parsed for JSON output and the version number is stored in CustomProperty7. Agent ID is stored as CustomProperty6. (NOTE: To rename the custom properties or reset the Session group, set the createdVersionSessionGroup setting to false, also do this if you change the custom property value number)
- Script can be manually invoked from the Automate tab on the Host screen or in the drop down menu when selecting sessions.
Sample Output
Diagnostic Details |
Agent Logs |
 |
 |
Troubleshooting
Set Verbose = 1 in the Extension settings to log more data for on-demand diagnostics. This does not apply to Guest Connect events.
Credit