Windows - Tray Notification - Customize Trusted Message

What the tray notification branding Worklet does

This Automox Worklet™ customizes the footer text displayed in Automox agent tray notifications on Windows endpoints. The Worklet calls the amagent notifications set_branding_message command to apply branding text to the agent interface.

The Worklet accepts a parameter for custom branding text and applies it to all agent notifications shown to users. The branding text is limited to 75 characters and persists across agent restarts.

Why customize agent notification branding

Users often question unfamiliar tray notifications and may open support tickets asking about unknown management tools on their systems. Without branding, the Automox agent appears as generic software rather than an authorized IT management tool.

Custom branding solves this challenge by displaying your IT department's name, contact information, or compliance messaging directly in agent notifications. Users immediately recognize the agent as legitimate software, reducing confusion and unnecessary support requests.

How tray notification branding works

1. Evaluation phase: The Worklet checks if the Automox Tray executable (amagent-ui.exe) is installed in the standard Program Files or Program Files (x86) directories. If the Tray is not found, remediation is skipped.

2. Remediation phase: The Worklet executes amagent.exe with the notifications set_branding_message command, passing the custom branding text as a message parameter. The command applies the text to all agent notifications and returns success if the operation completes without errors.

Tray branding configuration requirements

• Operating system: Windows 10, Windows 11, or Windows Server 2016 and later

• PowerShell version: 5.1 or later

• Automox Agent must be installed on the endpoint for branding to take effect

• Branding text parameter must not exceed 75 characters in length

• RunNow compatible for immediate execution on selected endpoints

Expected tray notification appearance after branding

After the Worklet executes successfully, you can expect these specific outcomes:

• All Automox agent tray notifications display your custom branding text in the footer

• The branding text persists across agent restarts and system reboots

• Users see the branded text at the bottom of every agent notification window

• The text remains until updated by running the Worklet again with new branding text

You can verify successful branding by clicking the Automox agent system tray icon and confirming the custom text appears at the bottom of the notification.

How to validate customize trusted message changes

1. Run this Worklet on a pilot Windows endpoint and review evaluation output for customize trusted message.

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.

4. Validate remediation effects from script operations such as Set-AmagentBrandingText, Test-Path, then rerun evaluation for compliance.

For technical validation, compare endpoint state to the Worklet evaluation logic and remediation flow for customize trusted message. 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 and remediation operations such as Set-AmagentBrandingText, Test-Path. Use these indicators to verify that endpoint changes match intended policy outcomes.

For technical validation, compare endpoint state to the Worklet evaluation logic and remediation flow for customize trusted message. 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 and remediation operations such as Set-AmagentBrandingText, Test-Path. Use these indicators to verify that endpoint changes match intended policy outcomes.