Technical Articles ID:
KB52707
Last Modified: 2023-03-28 10:09:32 Etc/GMT
Environment
McAfee Agent (MA) / Trellix Agent (TA) 5.x
Apple OS X, macOS
Linux
Microsoft Windows
UNIX
NOTE: MA was rebranded to TA in version 5.7.7.
Summary
This article provides command-line switches for MA / TA in Windows, Mac, or UNIX environments.
When you deploy MA / TA from ePolicy Orchestrator (ePO), the following command-line options are available for the MA / TA binary (CmdAgent.exe) to set up communications with the ePO server and policy enforcement.
Contents: Click to expand the section you want to view:
You can use the following switches with CmdAgent.exe on Windows clients.
NOTE: The switches are case-sensitive.
Switch
Description
/p
Collect and send properties to the ePO server.
/e
Enforce policies locally.
/c
Check for new policies.
The agent contacts the ePO server for new or updated policies, and then enforces them immediately on receipt.
/s
Display the Agent Monitor.
/i
MA / TA information displayed.
/h
List all switches with their description.
/l
Set the location of the log file.
You can use the following switches on non-Windows clients by changing to the correct directory. Then, for Mac or UNIX systems, run the command sudo ./cmdagent.
NOTES:
The switches are case-sensitive.
Switches on non-Windows systems use a - instead of /.
Although the Display Agent Monitor option isn't available, you can still view the current agent activity by using the following command:
NOTE: Run the command in a separate PuTTY/terminal session. You can issue the cmdagent command in one session and watch the agent activity in the other.
Switch
Description
-p
Collect and send properties to the ePO server.
-e
Enforce policies locally.
-c
Check for new policies.
The agent contacts the ePO server for new or updated policies, and then enforces them immediately on receipt.
-f
Forward events to the ePO server.
-i
MA / TA information displayed.
-h
List all switches with their description.
-l
Set the location of the log file.
General use:
MA / TA 5.x
Operating System
File Path
File Name
Windows
<Installation Path>\McAfee\Agent
CmdAgent.exe
UNIX
/opt/McAfee/Agent/bin
CmdAgent
Mac
/Library/McAfee/Agent/bin
CmdAgent
IMPORTANT: Use only one switch per command. Don't run a command with multiple switches (for example, CmdAgent.exe /p /e /c) because it can start multiple concurrent agent-server communications and can cause policy errors.