Partager via

WillReboot

  • Article

WillReboot spécifie dans quelles circonstances redémarrer l’ordinateur après l’exécution d’une commande synchrone.

Si des commandes supplémentaires doivent encore être traitées avant le redémarrage de l’ordinateur, ces commandes sont enregistrées. Après le redémarrage, les commandes synchrones restantes reprennent.

Les commandes RunSynchronous s’exécutent dans le contexte utilisateur dans le passe de configuration auditUser et dans le contexte système dans la passe spécialisée.

Valeurs

Toujours

Spécifie que l’ordinateur redémarre toujours immédiatement après l’exécution de la commande.

OnRequest

Spécifie que l’ordinateur redémarre une fois la commande exécutée, si nécessaire. Consultez les remarques pour obtenir un tableau des codes de retour possibles.

Jamais

Spécifie que l’ordinateur ne redémarre pas une fois la commande exécutée. Il s’agit de la valeur par défaut.

Notes

Si la valeur de WillReboot est OnRequest, la commande synchrone doit retourner l’un des codes suivants.

Code de retour Description

0

La commande a réussi. Aucun redémarrage n’est nécessaire.

1

La commande a réussi. Un redémarrage immédiat est nécessaire. Ensuite, la commande suivante peut être démarrée.

2

La commande est toujours en cours de traitement. Un redémarrage immédiat est nécessaire. Ensuite, la même commande doit être redémarrée. Ce code peut être retourné plusieurs fois.

Autres codes

Échec de la commande. Une erreur doit être retournée et l’installation doit être terminée.

Passes de configuration valides

auditUser

specialize

Hiérarchie parente

Microsoft-Windows-Deployment | RunSynchronous | RunSynchronousCommand | WillReboot

S'applique à

Pour obtenir une liste des éditions et architectures Windows prises en charge par ce composant, consultez Microsoft-Windows-Deployment.

Exemple XML

La sortie XML suivante montre comment définir des commandes synchrones.

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

RunSynchronousCommand