The power option parameters of AeXAgentUtil.exe command line utility do not work as expected
Last Updated October 12, 2017
When following the current help instructions for the "Computer power" section of the AeXAgentUtil.exe command line utility, listed below, the tool seems not to work correctly. Either there is no action taken, or the command executes in an unexpected way.
Shuts down the computer
/reboot | /restartpc
Restarts the computer
Logs off all the users or the specified session
Forces running applications to close
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
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
Allows user to specify the custom text to display to the user in the power action reminder window
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
Displays the predefined text in the power action reminder window indicating that the administrator has requested the power action
Power actions will be performed during maintenance windows only
The lack of detailed help documentation related to "Computer power" section of the AeXAgentUtil.exe command line utility, makes the outcomes unpredictable.
Symantec is working on the related improvements to the documenation. This will be complete in the next major version (8.5), currently scheduled for a Q2/Q3 of 2018 release window.
Until then be aware that the AexAgentUtil.exe command line utility requires some additional parameters to run and in a specific order, for it to function properly.
It requires /notify switch as a pre-requisite for /defer /msg /msg1 and /msg2 commands and a quotation marks for /msg switch in case of message with multiple words.
1. AexAgentUtil.exe /logoff /notify:5 - one of main power switches (/shutdown or /reboot or /logoff) first
2. AexAgentUtil.exe /logoff /notify:5 /defer:5 - alternative order no/logoff /defer:5 /notify:5
3. AexAgentUtil.exe /logoff /notify /msg:"IT Department notification about the software update" - multiple words in the message, therefore quotation marks are used
4. AexAgentUtil.exe /logoff /notify /maintenancewindow - to get the prompt the /notify switch is required
Subscribing will provide email updates when this Article is updated. Login is required to Subscribe