superops_agent_uninstall_windows.ps1 - limehawk/rmm-scripts GitHub Wiki

superops_agent_uninstall_windows.ps1

Uninstalls the SuperOps RMM agent from Windows systems using vendor's official uninstaller or registry-based MSI uninstallation.

Overview

Uninstalls the SuperOps RMM agent from Windows systems. Attempts to use the vendor's official uninstall program first, then falls back to registry-based MSI uninstallation if the official uninstaller is not found.

Purpose

This script provides a comprehensive uninstallation solution for the SuperOps RMM agent on Windows systems. It intelligently attempts multiple uninstallation methods to ensure successful removal, starting with the vendor's official uninstaller and falling back to standard MSI uninstall procedures when necessary.

Prerequisites

  • Windows PowerShell 5.1 or later
  • Administrator privileges (required for uninstallation)
  • SuperOps RMM agent currently installed

Configuration

Required Inputs

None - Script will automatically detect installed SuperOps agent

Settings

  • SuperOpsInstallPaths: List of common installation directories to check
  • UninstallRegistryPaths: Registry paths to search for uninstall strings
  • ProductNamePattern: Pattern to match SuperOps product names
  • SilentUninstallArgs: Arguments for silent MSI uninstall

Data Sources & Priority

  1. SuperOps uninstall program (C:\Program Files\SuperOps\uninstall.exe)
  2. Windows Registry (HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall)
  3. Windows Registry 32-bit (HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall)

Behavior

  • Searches for SuperOps uninstall program in common installation directories
  • If found, executes vendor's official uninstaller
  • If not found, searches registry for MSI uninstall information
  • Executes MSI uninstall with silent parameters
  • Reports progress and status to stdout
  • Exits with code 0 on success, 1 on failure

Security Notes

  • No secrets hardcoded
  • No network calls required
  • Requires administrator elevation
  • Uses vendor's official uninstall method when available
  • Falls back to standard MSI uninstall procedures

Exit Codes

  • 0: Success
  • 1: Failure

Example Output

[ INPUT VALIDATION ]
--------------------------------------------------------------
Administrator privileges: Confirmed
Searching for SuperOps installation...

[ OPERATION ]
--------------------------------------------------------------
Found SuperOps uninstall program: C:\Program Files\SuperOps\uninstall.exe
Executing vendor uninstaller...
Uninstallation process started
Waiting for uninstaller to complete...
Uninstallation completed successfully

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

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

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

Version History

  • v1.0.0 (2025-11-02): Initial migration from SuperOps
    • Modernized from legacy WMI approach
    • Added vendor uninstaller detection
    • Added registry-based fallback method
    • Removed hardcoded GUID dependency
    • Converted to Limehawk Style A format
    • Added comprehensive error handling
    • Added structured console output

Links