Deploying the Evo Agent using ConnectWise RMM
Summary
This article outlines the procedure for deploying the Evo Agent to Windows endpoints through ConnectWise RMM utilizing the InstallEvoAgent.ps1 PowerShell script.
The complete script and parameters are available HERE
- Open ConnectWise RMM.
- Navigate to Automation > Tasks > Add > Script Editor
- Name and label the script as desired
- Add Parameter
- Set Parameter name as 'EvoDirectory' > Check Required Field
- Set Parameter Type as Text String
- DO NOT SET Default Value
- Repeat the process creating Parameters named 'AccessToken' and 'Secret'
- Confirm Parameters show 'EvoDirectory', 'AccessToken', and 'Secret' on Task Summary tab
- In the Script Editor section click Add Row > Click 'Type to search function' and select 'HTTP download'
- Set the URL field as https://raw.githubusercontent.com/evosecurity/EvoWindowsAgentDeploymentScripts/refs/heads/master/InstallEvoAgent.ps1
- Set the output field as 'C:\Program Files (x86)\*User*\tmp\Evo\InstallEvoAgent.ps1'
- Check the 'Overwrite' and 'Create Directory' checkboxes
- Click the Save button
- In the Script Editor section click Add Row > Click 'Type to search function' and select 'PowerShell script'
- In the PowerShell Script Edit Window paste the script below
- You will need to enter you Environmental URL on this line
$EnvironmentUrl = "Enter your Environmental URL here" This is your Evo portal base URL (e.g., https://yourorg.evosecurity.com)
Note: You can change other parameters within the script as are listed here https://github.com/evosecurity/EvoWindowsAgentDeploymentScripts. Keep in mind any additional parameters will be applied any time the script is run.
If you would like to have the option to enter these additional parameters at the time the script is run you can create additional script parameters (as shown in steps 4 - 7) and add the parameter name to the script in this format '@Parameter Name@' the same way the 'EvoDirectory', 'AccessToken', and 'Secret' parameters are listed as '@EvoDirectory@', '@AccessToken@', and '@Secret@'.
- In the Script Editor section click Add Row > Click 'Type to search function' and select 'Script Log'
- In the Script Log Message window enter '%output%' and click Save
- In the Script Editor section for each line click the Operating System drop down and select Windows for each line.
- At the top of the screen click Save
After creating the installation script, navigate to Automation → Tasks, locate your Evo script, and select Schedule Script. Enter the tenant-specific parameters, then choose the target devices. Because these parameters are unique per tenant( client ), schedule and scope the job to one tenant ( client ) at a time.
