Details on aexagentutil.com and AeXNSAgent.com
search cancel

Details on aexagentutil.com and AeXNSAgent.com

book

Article ID: 150636

calendar_today

Updated On:

Products

IT Management Suite Client Management Suite Asset Management Suite Server Management Suite

Issue/Introduction

What are the differences between using aexagentutil.exe and aexagentutil.com (the same for aexnsagent.exe and aexnsagent.com)?

Environment

ITMS 8.x

Resolution

The COM version is a simple Windows console redirector application. It starts the EXE version and the output is returned to the console. If you start CMD.exe and type aexnsagent  + ENTER then the COM version will start instead of the EXE, this is how Windows loader works.

This way you can type “aexnsagent /?” or “aexnsagent /? > text.txt” or “aexnsagent | more” and any other command and get output into the console. Most of the old commands do not output anything , but the new commands like “computer power” or “/importprofile” do output execution result into the console.

These are the options available for AeXNSAgent.com and AeXAgentUtil.com in their Help menu:

<install path>:\Program Files\Altiris\Altiris Agent\
  
AeXAgentUtil.com / AeXNSAgent.com
  

Use:
AeXNSAgent [Parameters]

Use:
AeXAgentUtil [Parameters]

  
Parameters:Description:
/? | /h | /help                 Shows this help
/s | /silent                    Prevents messages output to Windows console
/v | /verbose                   Forces log messages output to Windows console
/eng                            Forces output of Windows console in English
  
  
Agent commands:Description:
/start                         Starts the Agent
/stop                          Stops the Agent
/restart                       Stops and starts the Agent
/recover                        Stops the Agent and restarts it only if it stopped without crashing
/sendbasicinventory            Forces the Agent to send basic inventory
/updateconfiguration           Forces the Agent to update configuration
/resetguid    This parameter has been deprecated.
/registerguid[:<delay sec>]     Forces the Agent to register on Notification Server after the optional delay
/enablerc[:yes | no]            Enable remote control compatibility mode for agent user interface
  
  
Package Server commands:Description:
/psrefreshall                  Perform refresh of all packages on Package Server
/psresendall                    Validate and secure Package Server folders, refresh all packages on Package Server and send the status to Notification Server
  
  
Agent diagnostics:Description:
/diags                          Enables the Agent diagnostics
/nodiags                       Disables the Agent diagnostics
  
  
Agent troubleshooting and uninstallation:Description:
/uninstall | /clean            Uninstalls the Agent
/uninstallagents               Uninstalls all the installed plug-ins
/removepsfiles                 Removes the files downloaded by the Package Server plug-in
/removepackageserver            Removes the files downloaded by the Package Server plug-in and uninstalls the Package Server plug-in
/registerclient                Registers all the core agent modules
  
  
Event logging:Description:
/nologging                     Disables the logging
/enablelogging:error           Enables the error logging
/enablelogging:warning         Enables the error and warning logging
/enablelogging:info            Enables the error, warning and informational events logging
/enablelogging:trace           Enables the error, warning, informational and trace events logging
/enablelogging:verbose          Enables the error, warning, informational, trace and verbose events logging
/enablelogging:debug            Enables the error, warning, informational, trace, verbose and debug events logging
/enablelogging                  Enables the default logging
  
  
Server switching:Description:
/server:<server> | /ns:<server> Switches the Agent to the new Notification Server specified by the host name <server>
/web:<web> | /nsweb:<web>      

Switches the Agent to the new Notification Server specified by the URL <web>

i.e. /nsweb:https://Server.Domain.Local

  
  
Computer power:Description:
/shutdown                      Shuts down the computer
/reboot | /restartpc           Restarts the computer
/logoff[:<session ID>]         Logs off all the users or the specified session
/force                         Forces running applications to close
/notify[:<limit min> | nolimit]Notifies user about the power action for the specified number of minutes and then performs the action automatically. There is no limit set by default, use option 'nolimit' to explicitly set no limit
/defer[:<limit min> | nolimit]  Allows user to defer the power action up to the specified number of minutes. There is no limit set by default, use option 'nolimit' to explicitly set no limit
/msg:text                      Allows user to specify the custom text to display to the user in the power action reminder window
/msg1                          Displays the predefined text in the power action reminder window indicating that some finished software setup has requested the power action. This is the message that is displayed by default
/msg2                           Displays the predefined text in the power action reminder window indicating that the administrator has requested the power action
/maintenancewindow              Power actions will be performed during maintenance windows only
  
  
Miscellaneous commands:Description:
/enableasp                     Enables use of ASP pages in IIS
/findcert[:Keyword,Keyword]Allows user to find a specific certificate installed by SMA based on a keyword, this can be part of the thumbprint, serial number, the certificate store name, or some other certificate properties. Multiple keywords can be used.
Example:
C:\SMA>AeXNSAgent.com /findcert:77c7,Issuers