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

Статья
06/19/2023

RunSynchronousCommand указывает одну команду, выполняемую во время заданного этапа конфигурации.

Чтобы запустить команду, которая должна завершиться до запуска других команд, используйте синхронные команды. Для запуска служб или команд, которые могут запускаться одновременно, используйте вместо этого RunAsynchronous .

Команды RunSynchronous всегда выполняются перед командами в том же проходе. RunSynchronous Команды выполняются в контексте пользователя в проходе конфигурации auditUser configuration pass и в системном контексте в рамках этапа конфигурации специализации.

Предупреждение

Не добавляйте команды, которые завершают или перезагружают компьютер; Вместо этого используйте параметр Microsoft-Windows-Deployment\RunSynchronous\RunSynchronousCommand\WillReboot.

Дочерние элементы

Параметр	Описание
Учетные данные	Указывает учетные данные, используемые при доступе к путям.
Описание	Указывает описание выполняемой команды.
Заказ	Указывает порядок выполнения команды.
Путь	Указывает путь к выполняемой команде.
WillReboot	Указывает, в каких обстоятельствах перезагрузить компьютер после выполнения синхронной команды.

Допустимые проходы конфигурации

auditUser

specialize

Родительская иерархия

Развертывание | Microsoft-Windows RunSynchronous | RunSynchronousCommand

Применение

Список выпусков и архитектур Windows, поддерживаемых этим компонентом, см. в разделе Microsoft-Windows-Deployment.

Пример применения предложения XML

В следующих выходных данных XML показано, как задать синхронные команды.

<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>

RunSynchronous

RunAsynchronous