Using AeXAgentUtil.exe command line utility for power option parameters

Products

• IT Management Suite

Issue/Introduction

 AeXAgentUtil.exe command line utility has the ability to use power option parameters. 

The following are the help instructions for the "Computer power" section of the AeXAgentUtil.exe command line utility:

/shutdown	Shuts down the computer
/reboot | /restartpc	Restarts the computer
/logoff[:]	Logs off all the users or the specified session
/force	Forces running applications to close
/notify[: | 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[: | 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

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Environment

ITMS 7.6, ITMS 8.x

Resolution

When using the AexAgentUtil.exe command line utility for power actions, it 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 quotation marks for /msg switch in case of message with multiple words.

 

Examples:

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