WillReboot (Standard 8 Module Reference)
7/8/2014
Review the applicable Embedded Core modules and any examples for the WillReboot setting in Windows Embedded 8 Standard (Standard 8).
This setting specifies in what circumstances to restart the device after running a synchronous command.
If there are any additional commands that have yet to be processed before the device restarts, those commands are saved. After the restart, the remaining synchronous commands resume.
The following table shows the possible values.
Value |
Description |
---|---|
Always |
Specifies that the device always restarts immediately after the command has run. |
OnRequest |
Specifies that the device restarts after the command has run, if requested. See the following table of possible return codes.
Return CodeDescription
0The command was successful. No restart is required.
1The command was successful. An immediate restart is required. Then, the next command can be started.
2The command is still in process. An immediate restart is required. Then, the same command must be restarted. This code can be returned multiple times.
Other codesThe command failed. An error must be returned and installation terminated.
|
Never |
Specifies that the device does not restart after the command has run. |
Modules
The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.
Module |
Path |
---|---|
Products/Embedded Core/Deployment/RunSynchronous/RunSynchronousCommand/WillReboot |
XML Example
This XML example shows how to specify that the device restarts after the command runs.
<RunSynchronous>
<RunSynchronousCommand wcm:action="add">
<Description>MySynchCommand1</Description>
<Path>\\network\server\share\filename</Path>
<WillReboot>OnRequest</WillReboot>
</RunSynchronousCommand>
</RunSynchronous>
For an XML example that shows how to set asynchronous commands, see Deployment with Synchronous Command XML Example.