Run Action Icon

Restart Action

Declaration

<AMRESTART FORCE="yes/no" DELAY="number" MESSAGE="text" COMPUTER="text" CONTINUE="yes/no">

See Also

Shut Down, Log Off

Description

Closes Windows and restarts the computer. On Windows NT/2000/XP any computer on the network may be specified. Windows 95/98/ME supports restarting the current machine only. Processing can optionally resume on the next line of the task after the computer is restarted.

Practical Usage

Example 1: Administrators could create and deploy a task with this action to force restart the system after an automated installation or file update has taken place.

Example 2: After modifications are made to the registry using the Registry <AMREGISTRY> action the system could be restarted to allow the changes to take effect on the system.

Parameters

General Tab

Force the system to shut-down without notifying applications
Yes/No, Optional - default NO
MARKUP: FORCE="YES"

Specifies that the system should shut down immediately without notifying and waiting for applications to return that they are ready to close.

Continue task execution after restart
Yes/No, Optional - default NO
MARKUP: CONTINUE="YES"

Specifies that the task should resume execution after the restart and after AutoMate starts up again. This is only supported when restarting the local machine.

Computer to Restart
Text, Optional - default "localmachinename"
MARKUP: COMPUTER="\\MACHINE3"

Specifies the machine to restart. This can be any valid machine name on the Windows network. In visual mode a dropdown is provided for convenience in selecting a machine name. If not specified the current machine is assumed. AutoMate must also be running under a user account that has privileges/rights to reboot other machines (such as an administrator account). Due to operating system limitations this parameter is not supported on Windows 95/98/ME systems, on these systems the current machine is assumed.

Prompt user to Log off
Yes\No, Optional - NO
MARKUP: PROMPT="YES"

Specifies that Windows should display a dialog to the user with a countdown notifying the user that the system is about to be restarted to give the user time to save his/her work. Due to operating system limitations this parameter is not supported on Windows 95/98/ME systems.

Seconds
Number, Optional - default - 5
MARKUP: DELAY="5"

Specifies the amount of time (in seconds) that windows should display the restart notification dialog. This parameter is only valid if the "Prompt user to log off" parameter is YES. Due to operating system limitations this parameter is not supported on Windows 95/98/ME systems.

Message to display in the shut down dialog box
Text, Optional - default (none)
MARKUP: MESSAGE="Please begin to panic now"

Specifies a user-definable message that windows should display the restart notification dialog. This parameter is only valid if the "Prompt user to log off" parameter is YES. The message will be displayed for the number of seconds specified in the "Seconds" parameter. Due to operating system limitations this parameter is not supported on Windows 95/98/ME systems.

Notes

Standard Error Handling Options
This action also includes the standard "Error Causes" and "On Error" failure handling options/tabs

More on Error Handling Options

Variables and Expressions
All text fields allow the use of expressions by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example

<AMRESTART>

<AMRESTART FORCE="YES" DELAY="5" MESSAGE="Save your documents and dive for cover - your system is goin' down" COMPUTER="\\MACHINE9" CONTINUE="YES">