Windows - Tray Notification - Reset Tooltip Text

What the tray tooltip reset Worklet does

This Automox Worklet™ resets the Automox Agent tray icon tooltip text to the default value of "Automox". The tooltip appears when you hover your mouse over the Automox Agent icon in the system tray, and it can be customized through other Worklets or manual configuration.

The Worklet uses the amagent.exe command-line tool with the notifications set_tray_tooltip command to apply the reset. This operation runs on endpoints where the Automox Agent tray application (amagent-ui.exe) is installed and the Agent version meets minimum requirements.

Why restore default tray tooltip text

Inconsistent tray icon tooltips across your endpoint fleet create user confusion and complicate support workflows. When different endpoints display varied custom branding messages instead of standard Automox identifiers, users struggle to recognize legitimate agent notifications and IT teams cannot provide consistent troubleshooting guidance. Outdated or incorrect custom tooltip text persists after organizational rebranding or mergers, displaying stale company names that undermine brand consistency and create security awareness gaps when users learn to ignore unfamiliar system tray messages.

The reset operation is simple and non-disruptive. It does not affect the core functionality of the Automox Agent and provides a quick way to update tray icon appearance without manual intervention on each endpoint.

How the tooltip reset works

1. Evaluation phase: The script verifies that amagent-ui.exe is installed in the standard Automox directory (Program Files or Program Files (x86)), retrieves the installed Automox Agent version from the Windows registry, and confirms the version is 2.5.0 or higher before proceeding.

2. Remediation phase: The script executes the amagent.exe command with parameters 'notifications', 'set_tray_tooltip', '--text', and 'Automox' to set the tooltip text back to default, then confirms successful completion.

Tray tooltip reset requirements

• Windows 10, Windows 11, or Windows Server 2016 and later

• Automox Agent version 2.5 or higher

• Automox Agent tray application (amagent-ui.exe) must be installed

• PowerShell 5.1 or later

• Can be executed through RunNow on individual endpoints, the endpoint page, or standard policy execution

Expected tray icon state after reset

After the Worklet completes successfully, the tray icon tooltip displays "Automox" when you hover your mouse over the Automox Agent icon in the system tray. Any custom tooltip text that was previously configured will be replaced with this default value.

The Worklet will skip execution on endpoints that do not have the Automox Agent installed or do not meet the minimum version requirement. You can verify the reset was applied by checking the tooltip text on the affected endpoints or reviewing the policy execution logs in the Automox console.

How to validate reset tooltip text changes

1. Run this Worklet on a pilot Windows endpoint and review evaluation output for reset tooltip text.

2. Confirm Automox activity logs show successful completion and exit code 0.

3. Verify endpoint state using checks aligned to evaluation script logic, such as Test-Path, Get-ItemProperty, Where-Object.

4. Validate remediation effects from script operations such as Get-ItemProperty, Where-Object, Reset-AmagentTooltip, then rerun evaluation for compliance.

For technical validation, compare endpoint state to the Worklet evaluation logic and remediation flow for reset tooltip text. This supports repeatable tray management workflows, faster change control review, and auditable compliance evidence.

Useful script references for this Worklet include evaluation operations such as Test-Path, Get-ItemProperty, Where-Object and remediation operations such as Get-ItemProperty, Where-Object, Reset-AmagentTooltip. Use these indicators to verify that endpoint changes match intended policy outcomes.