Mesh Agents¶
Windows¶
Default Install Path: c:\Program Files\Mesh Agent
Application Path: c:\Program Files\Mesh Agent\meshagent.exe
Application database Path: c:\Program Files\Mesh Agent\meshagent.db
Application Log Path: c:\Program Files\Mesh Agent\meshagent.log
xxx Path: c:\Program Files\Mesh Agent\meshagent.msh
- Start:
net start "mesh agent" - Stop:
net stop "mesh agent" - Restart:
net restart "mesh agent" - Status: Needs info
Troubleshooting steps: Needs info
Linux / BSD¶
Uninstall: sudo /usr/local/mesh_services/meshagent/[agent-name]/meshagent -fulluninstall
Apple macOS Binary Installer¶
Default Install Path: /usr/local/mesh_services/meshagent/meshagent
Launches from /Library/LaunchAgents/meshagent.plist
Controlling agent
launchctl stop meshagent
launchctl start meshagent
Install:
Uninstall: sudo /usr/local/mesh_services/meshagent/[agent-name]/meshagent -fulluninstall
Apple macOS Universal¶
For OSx 11+ including Big Sur, Monterey and later
Apple macOS¶
For macOS 10.x including Catalina, Mojave, High Sierra, Sierra, El Capitan, Yosemite, Mavericks, Mountain Lion and earlier.
Mobile Device (Android)¶
MeshCentral Assistant¶
See Assistant
Apple MacOS Binary Installer¶
Agent Commands¶
agentmsg : Add/Remove badged messages to the device's web ui
agentmsg add "[message]" [iconIndex]
agentmsg remove [index]
agentmsg list
agentupdate : Manually trigger an agent self-update
alert : Display an alert dialog on the logged in session
alert TITLE, CAPTION [, TIMEOUT]
amt
amtconfig
amtevents
apf
args
av : Displays Antivirus State
coredump
coreinfo
cpuinfo
cs : Display Windows Connected Standby State
dbcompact : Compacts the agent database
dbget
dbkeys
dbset
dnsinfo : Display DNS server info
domain : Display domain metadata
errorlog
eval : executes javascript on the agent
eval [code]
fdcount : Returns the number of active descriptors in the event loop
fdsnapshot : Returns detailed descriptor/handle/timer metadata
getclip : Fetches clipboard data from agent
getscript
help : Returns the list of supported console commands
httpget
info : Returns general information about the agent, such as connected state, loaded modules, LMS state, etc
kill : Sends a SIGKILL signal to the specified PID
kill [pid]
kvmmode : Displays the KVM Message Format
location : Displays saves location information about the connected agent
lock
log : Writes a message to the logfile
log [message]
ls : Enumerates the files in the agent's install folder
mousetrails : Enables/Disables Mouse Trails Accessibility on Windows. To change setting, specify a positive integer representing the number of latent cursors, where 0 is disable
mousetrails [n]
msh : Displays the loaded msh settings file
netinfo : Displays network interface information
notify : Display a notification on the web interface
openurl
osinfo : Displays OS information
parseuri : Parses the specified URI, and displays the parsed output
parseuri [uri]
plugin : Invokes a plugin
plugin [pluginName] [args]
power : Performs the specified power action
power [action]
LOGOFF = 1
SHUTDOWN = 2
REBOOT = 3
SLEEP = 4
HIBERNATE = 5
DISPLAYON = 6
KEEPAWAKE = 7
BEEP = 8
CTRLALTDEL = 9
VIBRATE = 13
FLASH = 14
privacybar : Sets/Gets the default pinned state of the Privacy Bar on windows
privacybar [PINNED|UNPINNED]
ps : Enumerates processes on the agent
rawsmbios : Fetches the raw smbios table
safemode : Sets/Gets the SAFEMODE configuration of the agent, as well as the next boot state.
safemode (ON|OFF|STATUS)
scanwifi : Scans the available Wifi access points, and displays the SSID and Signal Strength
service : Shortcut to be able to restart the agent service
service status|restart
setclip : Sets clipboard data to the agent
setclip [text]
setdebug : Sets the location target for debug messages
setdebug [target]
0 = Disabled
1 = StdOut
2 = This Console
* = All Consoles
4 = WebLog
8 = Logfile
smbios : Displays the parsed SMBIOS metadata
startupoptions : Displays the command-line options that the agent was started with
sysinfo : Collects and displays telemetry on the platform
task
taskbar : Hides or shows the Windows System task bar, optionally on the specified Terminal Server Session ID
taskbar HIDE|SHOW [TSID]
timerinfo : Displays metadata about any configured timers on the event loop
toast : Displays a toast message on the logged in user's session
toast [message]
translations : Shows the currently configured translations
type
type (filepath) [maxlength]
uac : Get/Sets the Windows UAC mode
uac [get|interactive|secure]
unzip
unzip input, destination
users : Enumerates the logged in users on the system
versions : Displays version information about the agent
vm : Detects if the system is a Virtual Machine
volumes : Displays volume information reported by the OS
wakeonlan : Sends wake-on-lan packets to the specified MAC address
wakeonlan [mac]
wallpaper : Gets/Toggles the logged in user's desktop background image
wallpaper (GET|TOGGLE)
wpfhwacceleration : Enable/Disable WPF HW Acceleration on Windows
wpfhwacceleration (ON|OFF|STATUS)
wsclose
wsconnect
wslist
wssend
zip
zip (output file name), input1 [, input n]
Agent msh options¶
You can find a full list of options for the agent here
skipmaccheck=1: Will not regenerate the agents nodeid and cause duplication of the agent when the MAC address changes.
You can add options to your .msh on agent install with this