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

Notion image
 

-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"

Notion image

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.

Notion image

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
SecureLoginElevatedLogin, 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.

Did this answer your question?
😞
😐
🤩