Windows - Tray Notification - Reset Branding Icon

What the Automox agent tray icon reset does

This Automox Worklet™ restores the Automox agent tray icon to its default branding state on Windows endpoints. Custom branding can be applied to the agent UI for organization-specific branding, but this Worklet provides the ability to revert to standard Automox branding.

The Worklet executes the amagent notifications set_icon --reset command on the endpoint. This command communicates with the Automox agent service to reset the tray icon configuration to factory defaults.

The Worklet validates that the Automox agent meets the minimum required version (2.5 or higher) before attempting the reset, verifying compatibility with the reset functionality.

Why reset the agent tray branding

Custom branding on the agent tray can help endpoints reflect your organization's visual identity. But you may need to revert to default Automox branding for consistency across different organizational units, after a rebrand transition, or to troubleshoot tray display issues.

Automating the reset process eliminates manual intervention on individual endpoints. Rather than requiring IT teams to navigate agent settings on each system, you can deploy this Worklet across your fleet to standardize the tray appearance in one operation.

The Worklet is designed for immediate execution through RunNow, allowing you to quickly remediate tray branding across endpoints without waiting for the next scheduled policy run.

How the branding icon reset works

1. Evaluation phase: The Worklet checks if the Automox Tray executable (amagent-ui.exe) is installed in the standard Automox directories, retrieves the current Automox agent version from the Windows registry, and verifies the agent meets version 2.5 or higher.

2. Remediation phase: The Worklet locates the amagent.exe executable in the Automox installation directory and executes the notifications reset command, which resets the tray icon configuration to default Automox branding.

Tray icon reset requirements

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

• Automox Agent version 2.5.0 or higher

• Automox Tray component installed on the endpoint

• PowerShell 5.1 or later

• Local administrative privileges on the endpoint

Expected tray appearance after reset

After the Worklet completes successfully, the Automox agent tray icon returns to standard Automox branding. The system tray notification area will display the default Automox icon for the Automox Agent. Any custom branding previously applied to the tray icon is removed and replaced with the standard Automox visual identity. You can verify this change through the Automox Activity Log or by checking the endpoint configuration directly.

You can verify the reset by viewing the system tray on the affected endpoint. The Automox Agent icon should match other endpoints in your organization that use default branding. The Worklet execution will complete with a success status, and no further action is required on the endpoint.

How to validate reset branding icon changes

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

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-AmagentBrandingIcon, then rerun evaluation for compliance.