Restaurer les personnalisations dans SharePoint Server

S’APPLIQUE À :2013 2016 2019 Édition d’abonnement SharePoint dans Microsoft 365

Vous pouvez restaurer toute personnalisation apportée à SharePoint Server à l'aide de Administration centrale ou PowerShell. L'outil de restauration que vous utilisez dépend du type d'environnement que vous avez déployé, des contraintes de votre planification et des contrats de niveau de service que vous avez établis avec votre organisation.

Avant de commencer

Avant de commencer cette opération, consultez les informations suivantes :

• Nous vous recommandons de conserver une sauvegarde du fichier .wsp d’origine et du code source servant à générer le fichier .wsp pour les solutions approuvées et bac à sable (sandbox).

Restauration de packages de solution dans SharePoint Server

La méthode que vous utilisez pour restaurer les packages de solution varie selon que les personnalisations sont déployées comme des solutions approuvées ou comme des solutions bac à sable.

Les solutions approuvées sont des solutions déployées par des administrateurs de batterie. Elles sont déployées dans la batterie entière et peuvent être utilisées sur n'importe quel site de la batterie. Elles sont stockées dans la base de données de configuration. Elles sont sauvegardées lorsqu'une batterie est sauvegardée à l'aide de la sauvegarde SharePoint Server, sont comprises dans les sauvegardes de type configuration uniquement et peuvent également être sauvegardées individuellement ou en tant que groupe. Elles sont visibles dans la hiérarchie de restauration.

Les solutions bac à sable (sandbox) sont des solutions que les administrateurs de collections de sites peuvent déployer sur une collection de sites unique. Elles sont stockées dans la base de données de contenu associée à la collection de sites dans laquelle elles sont déployées. Elles sont incluses dans les sauvegardes de batterie SharePoint Server, d'application web, de base de données de contenu et de collection de sites, mais elles ne sont pas visibles dans la hiérarchie de restauration et ne peuvent pas être sélectionnées ou restaurées individuellement.

Pour restaurer une solution approuvée à l’aide de l’Administration centrale, procédez comme suit :

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe SharePoint Administrateurs de batterie.

2. Démarrez l'Administration centrale.

3. Dans la page d'accueil de l'Administration centrale, dans la section Sauvegarde et restauration, cliquez sur Restaurer à partir d'une sauvegarde.

4. Dans la page Restauration à partir d'une sauvegarde - Étape 1 sur 3 : sélectionner la sauvegarde à restaurer, sélectionnez, dans la liste des sauvegardes, le travail de sauvegarde qui contient le package de solution, puis cliquez sur Suivant. Vous pouvez afficher plus de détails sur chaque sauvegarde en cliquant sur le signe (+) à côté de la sauvegarde.

   Notes

   Si la tâche de sauvegarde correcte ne s'affiche pas, tapez le chemin d'accès UNC (Universal Naming Convention) du dossier de la sauvegarde appropriée dans la zone de texte Emplacement de l'historique de sauvegarde, puis cliquez sur Actualiser.

5. Dans la page Restaurer à partir d'une sauvegarde - Étape 2 sur 3 : sélectionner un composant à restaurer, activez la case à cocher en regard de la solution, puis cliquez sur Suivant.

6. Dans la page Restaurer à partir d'une sauvegarde - Étape 3 sur 3 : sélectionner les options de restauration, dans la section Restaurer un composant, vérifiez que Solution apparaît dans la liste Restaurer le composant suivant.

   Dans la section Restaurer uniquement les paramètres de configuration, assurez-vous que l'option Restaurer le contenu et les paramètres de configuration est sélectionnée.

   Dans la section Options de restauration, sous Type de restauration, sélectionnez l'option Configuration existante. Une boîte de dialogue s’affiche pour vous demander de confirmer l’opération. Cliquez sur OK.

   Cliquez sur Lancer la restauration.

7. Vous pouvez afficher l'état général de tous les travaux de récupération en haut de la page État de la sauvegarde et de la restauration dans la section Disponibilité. Vous pouvez afficher l'état du travail de récupération en cours dans la partie inférieure de la page dans la section Restauration. La page d'état se met à jour automatiquement toutes les 30 secondes. Vous pouvez mettre à jour manuellement les détails de l'état en cliquant sur Actualiser. La sauvegarde et la récupération sont des travaux du service du minuteur. Par conséquent, le démarrage de la récupération peut prendre plusieurs secondes.

   Si des messages d'erreur s'affichent, vous pouvez les consulter dans la colonne Message d'échec de la page État des opérations de sauvegarde et de restauration. Vous trouverez également des détails supplémentaires dans le fichier Sprestore.log situé à l'emplacement UNC indiqué à l'étape 3.

Pour restaurer une solution approuvée à l’aide de PowerShell, procédez comme suit :

1. Vérifiez que vous êtes membre :

   • du rôle serveur fixe securityadmin sur l'instance SQL Server.

   • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

   • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

     Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

   Notes

   [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

2. Démarrez SharePoint Management Shell.

3. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

   Restore-SPFarm -Directory <BackupFolder> -RestoreMethod Overwrite -BackupId <GUID> -Item <SolutionPath>
   

   Où :

   • <BackupFolder> est l'emplacement UNC du répertoire à partir duquel effectuer la restauration.

   • <GUID> est le GUID de l'ID de sauvegarde à partir duquel vous souhaitez effectuer la restauration. Si vous ne spécifiez aucune sauvegarde, la plus récente est utilisée.

   • <SolutionPath> est le chemin de la solution dans l’arborescence de sauvegarde (généralement farm\solutions\ SolutionName).

Pour plus d'informations, voir Restore-SPFarm.

Restauration d’une solution bac à sable (sandbox)

Il est impossible de restaurer uniquement les personnalisations qui ont été déployées en tant que solutions bac à sable (sandbox). Au lieu de cela, vous devez restaurer la batterie, l'application web, la base de données de contenu ou la collection de sites à laquelle la personnalisation est associée.

Restauration d’éléments de site créés dans SharePoint Server

Vous ne pouvez pas restaurer uniquement les éléments de sites créés. Au lieu de cela, vous devez restaurer la batterie, l'application web ou la base de données de contenu à laquelle est associé l'élément de sites créé.

Restauration de flux de travail dans SharePoint Server

Les flux de travail constituent un cas particulier de personnalisation que vous pouvez restaurer. Assurez-vous que le plan de sauvegarde et de récupération gère les scénarios suivants qui s'appliquent à l'environnement :

• Les flux de travail déclaratifs, tels que ceux créés dans SharePoint Designer, sont stockés dans la base de données de contenu de la collection de sites sur laquelle ils sont déployés. La restauration de la base de données de contenu ou de la collection de sites restaure ces flux de travail.

• Les actions de flux de travail déclaratifs personnalisés ont des composants aux trois emplacements suivants :

  • Les assemblys Visual Studio 2013 pour les actions sont stockés dans le Global Assembly Cache.

  • Les fichiers de définition XML (fichiers .actions) sont stockés dans le répertoire 16\TEMPLATE<LCID>\Workflow.

  • Une entrée XML marquant l’action comme type autorisé est stockée dans le fichier Web.config des applications web dans lesquelles elle est utilisée.

    Si les flux de travail de batterie utilisent des actions personnalisées, vous devez recourir à un système de restauration de fichiers pour restaurer ces fichiers et les entrées XML. Vous pouvez réappliquer les fichiers selon les besoins après la récupération.

• Les flux de travail qui dépendent de code personnalisé, tels que ceux créés à l'aide de Visual Studio 2013, sont stockés à deux emplacements. Les assemblys Visual Studio 2013 pour le flux de travail sont stockés dans le Global Assembly Cache et les fichiers de définition XML sont stockés dans le répertoire Features. Cela est identique à d'autres types de fonctionnalités SharePoint Server telles que les composants WebPart et les récepteurs d'événements. Si le flux de travail a été installé dans le cadre d'un package de solution, suivez les instructions de restauration de packages de solutions.

• Si vous créez un flux de travail personnalisé qui interagit avec une collection de sites autre que celle dans laquelle le flux de travail est déployé, vous devez restaurer les deux collections de sites afin de restaurer le flux de travail. Une restauration de batterie suffit à restaurer toutes les collections de sites de la batterie et tous les flux de travail qui y sont associés.

• Les flux de travail qui ne sont pas déployés doivent être restaurés séparément à l’aide d’une application de sauvegarde de système de fichiers.

Restauration de modifications apportées au fichier Web.config dans SharePoint Server

Vous pouvez récupérer les modifications apportées au fichier Web.config à l'aide de l'Administration centrale ou des API SharePoint Server et du modèle objet en effectuant une restauration de batterie ou de type configuration uniquement.

Vous devez utiliser une sauvegarde de système de fichiers pour protéger les modifications apportées au fichier Web.config par un moyen autre que l'Administration centrale ou les API et le modèle objet SharePoint. Vous pouvez récupérer la sauvegarde par le biais d'une restauration du système de fichiers.

Restauration de personnalisations développées qui ne sont pas empaquetées en tant que solutions dans SharePoint Server

La restauration des personnalisations développées qui ne sont pas déployées sous la forme de solutions peut s’avérer complexe, car les emplacements des fichiers de personnalisation ne sont pas standardisés.

Contactez l'équipe de développement ou le fournisseur de personnalisation afin de déterminer si les personnalisations impliquent des logiciels complémentaires ou des fichiers à d'autres emplacements. Nous vous recommandons de restaurer les répertoires avec une solution de restauration de système de fichiers. Le tableau suivant répertorie les emplacements où les personnalisations sont généralement stockées sur des serveurs Web.

Voir aussi

Concepts

Sauvegarder les personnalisations dans SharePoint Server

Restaurer des batteries de serveurs dans SharePoint Server

Restaurer des configurations de batterie de serveurs dans SharePoint Server

Restaurer les applications web dans SharePoint Server

Restaurer des bases de données de contenu dans SharePoint Server

Restaurer des collections de sites dans SharePoint Server