superops_tray_icon_always_show.ps1 - limehawk/rmm-scripts GitHub Wiki

superops_tray_icon_always_show.ps1

Configures Windows system tray to always show the SuperOps RMM agent tray icon.

Overview

Configures Windows system tray settings to always show the SuperOps RMM agent tray icon. This ensures the SuperOps icon remains visible in the system tray notification area rather than being hidden in the overflow area.

Purpose

This script ensures that the SuperOps RMM agent tray icon is always visible to end users in the Windows system tray. By modifying the registry settings that control notification area icon visibility, it prevents the SuperOps icon from being automatically hidden in the overflow area, improving visibility and accessibility for users who need to interact with the agent.

Prerequisites

  • PowerShell 5.1 or later
  • Must run in user context (uses HKCU registry hive)
  • SuperOps agent must be installed (creates notification icon entries)
  • No elevation required (modifies current user's registry only)

Configuration

Required Inputs

None - Script automatically detects and configures SuperOps tray icon settings

Settings

  • Searches all notification icon registry entries for SuperOps-related entries
  • Sets IsPromoted=1 for matching entries (makes icon always visible)
  • Processes all users' notification area settings under HKCU context
  • Uses case-insensitive pattern matching for "superops"

Data Sources & Priority

  1. Windows Registry (HKCU:\Control Panel\NotifyIconSettings)
  2. Hardcoded search pattern ("superops")

Behavior

  • Enumerates all subkeys in HKCU:\Control Panel\NotifyIconSettings
  • Searches each key's properties for strings containing "superops"
  • When a match is found, sets the IsPromoted DWORD value to 1
  • Reports each modification made to the console
  • Continues processing even if individual keys fail to read
  • No restart required - changes take effect on next tray icon update

Security Notes

  • No secrets or credentials used
  • Only modifies current user's notification settings
  • Does not affect system-wide or other users' settings
  • Read-only access to detect SuperOps entries
  • Write access only to IsPromoted value (standard Windows setting)

Exit Codes

  • 0: Success
  • 1: Failure

Example Output

[ INPUT VALIDATION ]
--------------------------------------------------------------
Registry Path : HKCU:\Control Panel\NotifyIconSettings
Search Pattern : *superops*

[ OPERATION ]
--------------------------------------------------------------
Scanning notification icon settings...
Found 15 registered notification icons
Checking for SuperOps entries...
Set IsPromoted=1 for key: 1234567890
Processing complete

[ RESULT ]
--------------------------------------------------------------
Status : Success
Icons Modified : 1

[ FINAL STATUS ]
--------------------------------------------------------------
SuperOps tray icon configured to always show

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

Version History

  • v1.0.0 (2025-11-02): Initial migration from SuperOps
    • Converted to Limehawk Style A format
    • Added comprehensive error handling
    • Added structured console output
    • Fixed registry path string formatting issue
    • Added validation and reporting

Links