Share via

RunSynchronousCommand (microsoft-windows-setup-runsynchronous-runsynchronouscommand)

  • Article

RunSynchronousCommand specifies a single command to run during the windowsPE 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 RunAsynchronousCommand instead.

All RunSynchronous commands run in the system context.

Child Elements

Setting Description
Credentials Specifies the credentials used to access the command if the command is on a network share.
Description Describes the synchronous command to run.
Order Specifies the order of the command to run.
Path Specifies the path to the command to run.

Valid Configuration Passes

windowsPE

Parent Hierarchy

Microsoft-Windows-Setup | RunSynchronous | RunSynchronousCommand

Applies To

For the list of the Windows editions and architectures that this component supports, see Microsoft-Windows-Setup.

XML Example

The following XML output shows how to set synchronous commands.

<RunSynchronous>
   <!-- First synchronous command to run -->
   <RunSynchronousCommand>
      <Order>1</Order>
      <Path>\\MyNetworkShare\MyApplication.exe</Path>
      <Description>DescriptionOfMyApplication</Description>
      <Credentials>
         <Domain>FabrikamDomain</Domain>
         <UserName>MyUserName</UserName>
         <Password>MyPassword</Password>
      </Credentials>
   </RunSynchronousCommand>
<!-- Second synchronous command to run -->
   <RunSynchronousCommand>
      <Order>2</Order>
      <Path>C:\AnotherApplication.exe</Path>
      <Description>DescriptionOfMyApplication</Description>
   </RunSynchronousCommand>
</RunSynchronous>

RunSynchronous

RunAsynchronousCommand