Partager via

Automatiser l’installation des compléments lors de la phase d’installation

  • Article

S’applique à : Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 Essentials

Automatisation de l’installation des compléments lors de la phase d’installation

Pour installer des compléments lors de la phase d’installation, utilisez la méthode PostIC.cmd décrite à la section Création du fichier PostIC.cmd pour exécuter les tâches suivant la configuration initiale du présent document.

Ajoutez l’entrée suivante à votre fichier PostIC.cmd :

C:\Program Files\Windows Server\bin\Installaddin.exe <full path to wssx file> -q

Le complément prend maintenant en charge les étapes de préinstallation et de désinstallation personnalisée.

L’étape de préinstallation est exécutée avant l’installation de tous les fichiers .msi spécifiés dans addin.xml. Lorsque le mode interactif est exécuté, la boîte de dialogue de progression est affichée sans que la progression ne soit modifiée. Le bouton d’annulation est désactivé pendant la phase de préinstallation. Pour mettre en œuvre une étape de préinstallation, ajoutez les contenus suivants au fichier addin.xml (directement sous Package) :

Notes

Le schéma xml doit correspondre exactement à celui montré ci-dessous :

<Package xmlns="https://schemas.microsoft.com/WindowsServerSolutions/2010/03/Addins" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Id>...</Id>
  <Version>...</Version>
  <Name>...</Name>
  <Allow32BitOn64BitClients>...</Allow32BitOn64BitClients>
  <ServerBinary>...</ServerBinary>
  <ClientBinary32>...</ClientBinary32>
  <ClientBinary64>...</ClientBinary64>
  <SupportedSkus>...</SupportUrl>
  <SupportUrl>...</SupportUrl>
  <Location>...</Location>
  <PrivacyStatement>...</PrivacyStatement>
  <OtherBinaries>...</OtherBinaries>
  <Preinstall>
<Executable>exefile</Executable>
<NormalArgs>args-for-interactive-mode</NormalArgs>
<SilentArgs>args-for-silent-mode</SilentArgs>
<IgnoreExitCode>true</IgnoreExitCode>
  </Preinstall>
  <UninstallConfirm>...</UninstallConfirm>
</Package>
<¦>
<¦>

Le « exefile » est le fichier exécutable dans le package de compléments qui exécute l’étape de préinstallation et doit être spécifié. NormalArgs spécifie des arguments devant être transmis au fichier exécutable dans la ligne de commande en cas d'utilisation du mode interactif. Dans ce mode, le fichier exécutable peut afficher des boîtes de dialogue contextuelles pour l’interaction entre utilisateurs. SilentArgs spécifie des arguments devant être transmis au fichier exécutable dans la ligne de commande en cas d’utilisation du mode silencieux (-q est spécifié en cas d'invocation de installaddin.exe). Le fichier exécutable ne doit pas afficher de boîtes de dialogue contextuelles dans ce mode. Si IgnoreExitCode est spécifié avec Vrai, l’étape de préinstallation est toujours considérée comme réussie, sinon le code de sortie 0 indique la réussite, 1 indique l’annulation, et d’autres valeurs indiquent un échec. Les balises NormalArgs, SilentArgs et IgnoreExitCode sont toutes optionnelles.

Une étape de désinstallation personnalisée peut être utilisée dans l’un des cas suivants :

  • Remplacer la boîte de dialogue de confirmation intégrée.

  • Remplir des boîtes de dialogue personnalisées avant la désinstallation.

  • Exécuter certaines tâches avant la désinstallation.

    Pour mettre en œuvre une étape de désinstallation, ajoutez les contenus suivants au fichier addin.xml (directement sous Package) :

<Package xmlns="https://schemas.microsoft.com/WindowsServerSolutions/2010/03/Addins" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Id>...</Id>
  <Version>...</Version>
  <Name>...</Name>
  <Allow32BitOn64BitClients>...</Allow32BitOn64BitClients>
  <ServerBinary>...</ServerBinary>
  <ClientBinary32>...</ClientBinary32>
  <ClientBinary64>...</ClientBinary64>
  <SupportedSkus>...</SupportUrl>
  <SupportUrl>...</SupportUrl>
  <Location>...</Location>
  <PrivacyStatement>...</PrivacyStatement>
  <OtherBinaries>...</OtherBinaries>
  <Preinstall>¦</Preinstall>
<UninstallConfirm>
<Executable>full-path-to-exefile</Executable>
<Arguments>command-line-arguments</Arguments>
</UninstallConfirm>
</Package>

full-path-to-exefile spécifie le fichier exécutable déjà installé sur le système. Arguments est optionnel et spécifie les arguments de la ligne de commande pour le fichier exécutable. Le fichier exécutable est invoqué avant l'affichage de la boîte de dialogue intégrée de confirmation de la désinstallation.

Le fichier exécutable peut exécuter les tâche suivantes pendant cette phase :

  • Afficher certaines boîtes de dialogue pour l’interaction entre utilisateurs.

  • Exécuter certaines tâches en arrière-plan.

    Le code de sortie de ce fichier exécutable détermine comment le processus de désinstallation progresse :

  • 0 : le processus de désinstallation continue sans remplir la boîte de dialogue de configuration intégrée, comme l'utilisateur l'a déjà confirmé. (cette approche peut être utilisée pour remplacer la boîte de confirmation intégrée) ;

  • 1 : le processus de désinstallation est annulé, et, enfin, un message annulé est affiché pour l'utilisateur. Rien n'est modifié ;

  • Autre : le processus de désinstallation continue avec la boîte de dialogue de confirmation intégrée, tout comme l'étape de désinstallation personnalisée n'est pas présente.

    Tout échec de l'invocation du fichier exécutable provoquera le même comportement si le fichier exécutable renvoie un code autre que 0 ou 1.

Voir aussi

Création et personnalisation de l’imagePersonnalisations supplémentairesPréparation de l’image pour le déploiementTest de l’expérience client