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

RunSynchronousCommand gibt einen einzelnen Befehl an, der während des angegebenen Konfigurationsdurchlaufs ausgeführt werden soll.

Um einen Befehl zu starten, der abgeschlossen werden muss, bevor andere Befehle gestartet werden können, verwenden Sie synchrone Befehle. Um Dienste oder Befehle auszuführen, die gleichzeitig gestartet werden können, verwenden Sie stattdessen RunAsynchronous.

RunSynchronous-Befehle werden immer vor Befehlen in demselben Durchlauf ausgeführt. RunSynchronous Befehle werden im Benutzerkontext im auditUser-Konfigurationsdurchgang und im Systemkontext im speziellen Konfigurationsdurchgang ausgeführt.

Warnung

Fügen Sie keine Befehle hinzu, die den Computer herunterfahren oder neu starten; Verwenden Sie stattdessen die Einstellung: Microsoft-Windows-Deployment\RunSynchronous\RunSynchronousCommand\WillReboot.

Untergeordnete Elemente

Einstellung Beschreibung
Anmeldeinformationen Gibt die Anmeldeinformationen an, die beim Zugriff auf Pfade verwendet werden sollen.
Beschreibung Gibt eine Beschreibung des auszuführenden Befehls an.
Order Gibt die Reihenfolge des auszuführenden Befehls an.
Pfad Gibt den Pfad zum auszuführenden Befehl an.
WillReboot Gibt an, unter welchen Umständen der Computer neu gestartet werden soll, nachdem ein synchroner Befehl ausgeführt wurde.

Gültige Konfigurationsdurchläufe

auditUser

specialize

Übergeordnete Hierarchie

Microsoft-Windows-Deployment | RunSynchronous | RunSynchronousCommand

Gilt für

Die Liste der von dieser Komponente unterstützten Windows-Editionen und -Architekturen finden Sie unter Microsoft-Windows-Deployment.

XML-Beispiel

Die folgende XML-Ausgabe zeigt, wie synchrone Befehle festgelegt werden.

<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