As of May 14, 2024, Knowledge Base (KB) articles will only be published and updated in our new Trellix Thrive Knowledge space.
Log in to the Thrive Portal using your OKTA credentials and start searching the new space. Legacy KB IDs are indexed and you will be able to find them easily just by typing the legacy KB ID.
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.