Enable Agent Tray

What the Agent Tray enabler does

This Automox Worklet™ enables the Automox Agent Tray on Windows endpoints by removing the 'amagent-ui-disable' file from the Automox installation directory. This restores access to the tray interface that displays agent status, scheduling information, and system preferences.

The Worklet first checks if the Automox Agent Tray executable exists in the standard installation paths. If the tray is installed but the disable file is present, the Worklet removes the file to re-enable the interface.

This is useful when you previously disabled the tray for operational reasons but now need to restore user visibility into the Automox agent status and allow access to tray preferences and actions.

Why enable the Agent Tray on Windows

Organizations face operational challenges that require automated solutions. The Agent Tray provides critical visibility into the Automox agent's operational status. Users and IT teams can view when the agent last ran, review pending patches, and access scheduled maintenance windows directly from the Windows system tray without opening additional interfaces.

Enabling the tray improves communication between Automox and your endpoints. Users understand what maintenance activities the agent is performing and when scheduled tasks will occur. This reduces support tickets related to unexpected endpoint reboots or patching activities.

For IT operations teams, the tray serves as a quick diagnostic tool when troubleshooting agent connectivity issues or verifying successful remediation across your endpoint fleet.

How Agent Tray enablement works

1. Evaluation phase: The Worklet searches for the Automox Agent Tray executable (amagent-ui.exe) in the standard installation paths. It checks whether the 'amagent-ui-disable' file exists in the Automox directory. If the tray is installed and the disable file is present, remediation proceeds. If the tray is not installed or the disable file is absent, the Worklet exits without making changes.

2. Remediation phase: The Worklet removes the 'amagent-ui-disable' file from the Automox directory using PowerShell. Removing this file immediately re-enables the Agent Tray interface. The next time the Automox agent starts or the user logs in, the tray will appear in the Windows system tray with full functionality restored.

Agent Tray enablement requirements

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

• PowerShell 5.1 or higher installed on the endpoint

• Automox Agent must be installed with the tray component (standard installation)

• Administrative privileges required to remove the disable file from the Automox directory

Expected Agent Tray behavior after enablement

After successful remediation, the Automox Agent Tray icon appears in the Windows system tray. Users and IT teams can click the icon to access agent status information, view scheduled maintenance windows, and open the Automox preferences panel. The tray displays the current synchronization status and indicates when the agent last completed its evaluation and remediation cycles.

The enablement takes effect immediately on endpoints where the agent is already running. If the agent is not currently active, the tray will appear during the next agent startup or user login session. You can verify successful enablement by checking the Windows system tray or reviewing the Automox agent logs for confirmation that the disable file was successfully removed.

How to validate enable agent tray changes

1. Run this Worklet on a pilot Windows endpoint and review evaluation output for enable agent tray.

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, Split-Path, Join-Path.

4. Validate remediation effects from script operations such as Enable-AmagentTray, Test-Path, Join-Path, then rerun evaluation for compliance.