Deploy & Uninstall Evo Agent via PowerShell
Evo Credential Provider Installer (v2.3+ Only)
This article contains a PowerShell script to install, upgrade, or remove the Evo Credential Provider on Windows systems. It supports both interactive and silent operation modes, enabling easy integration into manual admin workflows or automated deployment systems (e.g., RMM tools, Intune, GPO, etc.).
Basic Install Script
.\InstallEvoAgent.ps1 -EnvironmentUrl "
https://myorg.evosecurity.com
" -EvoDirectory "MyOrg" -AccessToken "abc123" -Secret "xyz789"
Note: if you’re looking to install a beta agent, please append -Beta
to your Basic Install Script.
Manual Installation Example
This Basic script invokes the “InstallEvoAgent.ps1” and will need to be saved locally
at your desired path when you plan to Deploy.
Example: Save “InstallEvoAgent.ps1” to C:\Scripts Locally > CD C:\Scripts
in Administrator PowerShell > Run Basic Install Script
Note: In the Example Below I’m using additional Flags for Enabling End User Elevation & Addition of a failsafe user

-EnvironmentUrl, -EvoDirectory, -AccessToken, and -Secret parameters are required except on upgrades or removal. When upgrading, any unspecified parameters are inherited from the previous install.
NinjaRMM Example
In NinjaRMM you can go to Administration > Library > Automation and Click + Add > New Script. From here you can go to our GitHub where we have our InstallEvoAgent.ps1 script and Copy & Paste the entire script into Ninja.
On the right hand side you will then name the script, choose PowerShell for the language, operating system, Architecture & what it will Run as.
Then in parameters you would click add and then input your desired parameters which include -EviromentURL, -EvoDirectory, -AccessToken, -Secret
Example:
-EnvironmentUrl "
https://myorg.evosecurity.com
" -EvoDirectory "MyOrg" -AccessToken "abc123" -Secret "xyz789"

Once all of that is configured you can hit “Save” on the top right and then you can proceed to go to your devices in Ninja > Run Automation > Script and choose the newly saved Evo Install.PS1 script you just configured.
Once ran and completed you will see so in Ninja.

Additionally, our installation script includes additional parameters that allow for a more robust and customizable deployment, should you wish to extend beyond the basic installation script.
Parameter | Description | Default |
-EnvironmentUrl | Evo portal base URL (e.g., https://yourorg.evosecurity.com ) | |
-EvoDirectory | Your Evo organization/directory name | |
-AccessToken | Evo API access token | |
-Secret | Evo API secret | |
-FailSafeUser | Optional username to use as a fallback if Evo login fails | |
-MFATimeOut | Optional grace period to not require MFA for an unlock (in minutes from previous MFA prompt) | 0 |
-CredentialMode | SecureLogin , ElevatedLogin , or SecureAndElevatedLogin | SecureAndElevatedLogin |
-OnlyEvoLoginCredential | If set, Evo becomes the only credential provider | 0 |
-RememberLastUserName | Optional flag to remember the last username used | 1 |
-DisableUpdate | Optional flag to disable auto updates | 0 |
-JitMode | Optional flag to enable Just-In-Time admin accounts | 0 |
-EndUserElevation | Optional flag to enable end-user elevation | 0 |
-UserAdminEscalation | Optional flag to prompt admins with the end-user elevation prompt instead of the standard UAC prompt | 0 |
-NoElevatedRDP | Optional flag to disable elevation for RDP sessions when Evo is the sole login agent | 1 |
-MSIPath | Optional path to .msi or .zip file | |
-Upgrade | Ensure only newer versions replace installed ones | |
-Remove | Uninstalls the Evo Credential Provider | |
-Interactive | Runs installer with UI instead of silent mode | |
-Log | Enables install/uninstall logging | |
-Beta | Pulls installer from Evo's beta channel | |
-Json | Legacy option to supply a JSON config blob or file | |
-Help | Displays built-in help text | |
-CustomPrompt | Optional string to customize the login prompt | |
-CustomImage | Optional path to custom login image (URL or local file path |
Features
- Installs the Evo Credential Provider MSI or ZIP package (automatically extracts ZIP)
- Automatically downloads the latest stable or beta version if no path is provided
- Supports uninstall/removal logic
- Silent mode support for unattended installations
- Upgrade-safe: checks version before proceeding
- Accepts legacy JSON blob configs or individual parameters
- Includes integrated
Help
functionality and CLI examples
Removal
.\Install-EvoAgent.ps1 -Remove -Interactive -Log
Legacy JSON Blob
.\Install-EvoAgent.ps1 -Json '{ "EnvironmentUrl": "...", "EvoDirectory": "...", "AccessToken": "...", "Secret": "..." }’
Legacy JSON File
.\Install-EvoAgent.ps1 -Json 'c:\path\to\install.json’
Notes
- Admin Rights Required: Must be run from an elevated shell unless
Interactive
is used.
- Supports both x64 and ARM64 architectures.
- Logs (if enabled) are written to the system temporary folder.
Evo Security has also set up a new Git Repo for this deployment script. If you want to help change anything in there, feel free to open a pull request. If you find an issue, you can use the GitHub issues to let us know.
Please contact support@evosecurity.com for assistance.