Mise à niveau à partir d’une solution de batterie
Dernière modification : mardi 11 janvier 2011
S’applique à : SharePoint Foundation 2010
Cette rubrique explique comment mettre à jour des solutions de batterie.
Deux approches de mise à niveau
Il existe deux façons de mettre à niveau une solution de batterie. La méthode que vous choisissez dépend des types de modifications qui ont été apportées dans la version la plus récente de la solution.
Remplacement : l’ancienne version de la solution est retirée et éventuellement supprimée du magasin de solutions de batterie. La nouvelle version est alors ajoutée au magasin de solutions et déployée. Le nouveau package de solution (fichier .wsp) ne doit pas nécessairement avoir le même nom ou GUID que l’ancienne version ; toutefois, si l’ancienne version est retirée, mais qu’elle n’est pas supprimée du magasin de solutions, la nouvelle version doit avoir un nom de fichier et un GUID différents. Ce type de mise à niveau doit être utilisé si la nouvelle version de la solution diffère de la version installée de l’une des manières suivantes.
La nouvelle version supprime une fonctionnalité qui figurait dans l’ancienne version ou ajoute une fonctionnalité qui n’était pas présente dans l’ancienne version.
La nouvelle version modifie l’ID d’une fonctionnalité.
La nouvelle version modifie l’étendue d’une fonctionnalité.
La nouvelle version comporte un récepteur de fonctionnalité dont la version a été modifiée.
La nouvelle version ajoute un nouveau fichier elements.xml, supprime un fichier elements.xml ou modifie le contenu d’un fichier elements.xml existant.
La nouvelle version ajoute un nouvel élément Property à un fichier Feature.xml, supprime un élément Property d’un fichier Feature.xml ou modifie la valeur d’un élément Property dans un fichier Feature.xml.
Pour plus d’informations sur le retrait et le déploiement, voir Désinstallation et retrait d’une solution de batterie de serveurs et Installation et déploiement d'une solution de batterie de serveurs.
Mise à jour : une nouvelle version du package de solution est installée et déployée avec un nom de fichier différent, mais avec le même GUID que l’ancienne version. L’infrastructure de déploiement Microsoft SharePoint Foundation détecte que les GUID sont identiques. Elle retire automatiquement l’ancienne version avant de déployer la nouvelle version. Si la solution comprend des fonctionnalités, la nouvelle version et l’ancienne version ont alors le même jeu de fonctionnalités ; celles-ci restent activées, mais les assemblys et d’autres fichiers contenus dans ceux-ci sont mis à jour avec les versions du nouveau package de solution.
À chaque mise à niveau réussie d'une solution, la version précédente de cette solution est sauvegardée et stockée dans le magasin de configuration. Cette sauvegarde est utilisée par l'infrastructure de solution en cas de défaillance de la mise à niveau. Une seule copie de la sauvegarde est stockée pour chaque solution.
Les administrateurs de batterie effectuent une mise à niveau de type Mise à jour avec la commande Update-SPSolution dans SharePoint Management Shell.
Mise à jour par programme
L’exécution d’une mise à niveau de type Remplacement par programme revient à retirer par programme l’ancienne solution, puis à ajouter et déployer la nouvelle version. Pour exécuter une mise à niveau de type Mise à jour par programme, votre code appelle l’une des surcharges de la méthode SPSolution.Upgrade(). Pour que cette méthode puisse s’exécuter, une solution doit être présente dans le magasin de solutions. Celle-ci peut avoir été ou non déployée.
Si la solution n’est pas déployée, appelez la méthode SPSolution.Upgrade(String) pour mettre à jour la solution dans le magasin de solutions. Si la solution est déployée, appelez la méthode SPSolution.Upgrade(String, DateTime) pour démarrer le travail du minuteur pour la mise à niveau. Dans les deux cas, une sauvegarde de l’ancienne version de la solution est créée.
Voir aussi
Concepts
Installation et déploiement d'une solution de batterie de serveurs
Désinstallation et retrait d’une solution de batterie de serveurs