Skip to content

superops_agent_install.ps1

Corey Watson edited this page Dec 1, 2025 · 1 revision

superops_agent_install.ps1

Downloads and installs the SuperOps RMM agent on Windows systems.

Overview

Downloads and installs the SuperOps RMM agent on a Windows system using the MSI installer. This script is designed for automated deployment in RMM environments where the agent download URL is provided as an environment variable.

Purpose

Downloads and installs the SuperOps RMM agent on a Windows system using the MSI installer. This script is designed for automated deployment in RMM environments where the agent download URL is provided as an environment variable.

Prerequisites

  • PowerShell 5.1 or later
  • Administrator privileges (required for MSI installation)
  • Internet access to download agent installer
  • AGENT_URL environment variable must be set by RMM platform

Configuration

Required Inputs

  • AGENT_URL : (The download URL for the SuperOps agent MSI installer. This is typically injected by the RMM platform as an environment variable.)

Settings

  • Uses silent installation mode (/qn) for unattended deployment
  • Automatically accepts license agreement
  • Waits for installation to complete before exiting
  • Downloads installer to current working directory
  • Cleans up installer file after successful installation

Behavior

  • Downloads the SuperOps agent MSI from the provided URL
  • Installs silently without user interaction
  • Reports progress and status to console
  • Exits with code 0 on success, 1 on failure
  • All-or-nothing: any failure stops the script immediately

Security Notes

  • No secrets are hardcoded in this script
  • Agent URL is provided by RMM environment variable
  • Uses HTTPS for secure download (if URL is HTTPS)
  • MSI is executed with standard Windows Installer security context

Exit Codes

  • 0 success
  • 1 failure

Example Output

[ INPUT VALIDATION ]
--------------------------------------------------------------
Agent URL : https://app.superops.com/downloads/agent.msi

[ OPERATION ]
--------------------------------------------------------------
Downloading agent from URL...
Download completed: agent.msi (Size: 15.2 MB)
Starting silent installation...
Installation completed successfully
Cleaning up installer file...

[ RESULT ]
--------------------------------------------------------------
Status : Success

[ FINAL STATUS ]
--------------------------------------------------------------
SuperOps agent installed successfully

[ SCRIPT COMPLETED ]
--------------------------------------------------------------

Version History

  • 2025-11-02 v1.0.0 Initial migration from SuperOps
    • Converted to Limehawk Style A format
    • Added comprehensive error handling
    • Added structured console output
    • Added installer cleanup after successful install

Links

Clone this wiki locally