RunSynchronousCommand (microsoft-windows-deployment-runsynchronous-runsynchronouscommand)
RunSynchronousCommand specifies a single command to run during the specified configuration pass.
To start a command that needs to finish before other commands can start, use synchronous commands. To run services or commands that can start at the same time, use RunAsynchronous instead.
RunSynchronous commands always run before commands in the same pass. RunSynchronous commands run in the user context in the auditUser configuration pass configuration pass and in the system context in the specialize configuration pass.
Warning
Do not add commands that shut down or reboot the computer; instead, use the setting: Microsoft-Windows-Deployment\RunSynchronous\RunSynchronousCommand\WillReboot.
Child Elements
| Setting | Description |
|---|---|
| Credentials | Specifies the credentials to use when accessing paths. |
| Description | Specifies a description of the command to run. |
| Order | Specifies the order of the command to run. |
| Path | Specifies the path to the command to run. |
| WillReboot | Specifies in what circumstances to restart the computer after running a synchronous command. |
Valid Configuration Passes
auditUser
specialize
Parent Hierarchy
Microsoft-Windows-Deployment | RunSynchronous | RunSynchronousCommand
Applies To
For the list of the Windows editions and architectures that this component supports, see Microsoft-Windows-Deployment.
XML Example
The following XML output shows how to set synchronous commands.
<RunSynchronous>
<RunSynchronousCommand wcm:action="add">
<Credentials>
<Domain>MyDomain</Domain>
<Password>MyPassword</Password>
<Username>MyUsername</Username>
</Credentials>
<Description>MySynchCommand1</Description>
<Order>1</Order>
<Path>\\network\server\share\filename</Path>
<WillReboot>OnRequest</WillReboot>
</RunSynchronousCommand>
<RunSynchronousCommand wcm:action="add">
<Credentials>
<Domain>MyDomain</Domain>
<Password>MyPassword</Password>
<Username>MyUsername</Username>
</Credentials>
<Description>MySynchCommand2</Description>
<Order>2</Order>
<Path>\\network\server\share\filename</Path>
<WillReboot>OnRequest</WillReboot>
</RunSynchronousCommand>
</RunSynchronous>