Sauvegarder les personnalisations dans SharePoint Server

Article
03/08/2023

S’APPLIQUE À : oui-img-13 2013 oui-img-16 2016 oui-img-19 2019 oui-img-se Édition d’abonnement no-img-sop SharePoint dans Microsoft 365

Vous pouvez sauvegarder des personnalisations effectuées sur des sites SharePoint Server par le biais du le site Web Administration centrale de SharePoint ou de Microsoft PowerShell. L'outil de sauvegarde que vous utilisez dépend du type d'environnement que vous avez déployé, de vos exigences en matière de planification de la sauvegarde et des contrats de niveau de service (SLA) convenus avec votre organisation.

Avant de commencer

Avant de commencer cette opération, passez en revue la liste des personnalisations qu’il est possible de réaliser sur vos sites :

Personnalisations empaquetées en tant que solutions (fichiers .wsp). Les solutions contiennent des éléments de sites développés et sont généralement créées par des développeurs. Les éléments de sites développés sont notamment les suivants :
- Composants WebPart
- Flux de travail
- les définitions de site et de liste ;
- les convertisseurs de documents ;
- les récepteurs d’événements ;
- Travaux du minuteur
- Assemblys
Les éléments de site créés, qui sont généralement créés par des concepteurs web, ne sont pas compilés explicitement et se trouvent dans une base de données de contenu. Parmi ces éléments, citons :
- Pages maîtres
- les feuilles de style en cascade ,
- Formulaires
- les pages de disposition.
Modifications apportées au fichier Web.config
Les solutions tierces et leurs fichiers binaires et clés de Registre associés, par exemple les IFilters.
Modifications de sites apportées directement par le biais d’un navigateur
Personnalisations développées qui ne sont pas empaquetées en tant que solutions

Notes

Chacun de ces types de personnalisations exige un type de sauvegarde différent.

Sauvegarder des packages de solutions dans SharePoint Server

Les packages de solutions peuvent être créés à l'aide de SharePoint Designer ou de Visual Studio. Il est vivement recommandé de déployer toutes les personnalisations en tant que packages de solutions. Pour plus d'informations, consultez l'article relatif à la création de packages de solution SharePoint.

Un package de solution est un fichier déployable et réutilisable qui peut contenir un ensemble de fonctionnalités, de définitions de sites et d'assemblys qui s'appliquent à des sites et que vous pouvez activer ou désactiver individuellement. Les packages de solutions peuvent inclure des composants WebPart, des définitions de sites ou de listes, des colonnes personnalisées, des nouveaux types de contenu, des champs personnalisés, des actions personnalisées, des flux de travail codés, ou des activités et conditions de flux de travail.

La méthode qui vous permet de sauvegarder des packages de solutions est déterminée par le type de déploiement des personnalisations, solutions approuvées ou solutions bac à sable (sandbox) (code partiellement approuvé).

Les solutions approuvées sont des packages de solutions déployés 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 et sont comprises dans les sauvegardes de type configuration uniquement. Vous pouvez également sauvegarder des solutions approuvées individuellement ou en tant que groupe. Les solutions sont visibles dans la hiérarchie de sauvegarde.

Les solutions bac à sable (sandbox) sont des packages de 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 les packages de solutions sont déployés. Ils sont inclus dans la batterie de serveurs SharePoint Server, l’application web, la base de données de contenu et les sauvegardes de collection de sites, mais ne sont pas visibles dans la hiérarchie de sauvegarde et ne peuvent pas être sélectionnés ou sauvegardés individuellement.

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 les solutions bac à sable (sandbox).

Pour sauvegarder des solutions approuvées à l'aide de l'Administration centrale

Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.
Démarrez l'Administration centrale.
Dans la page d'accueil de l'Administration centrale, dans la section Sauvegarde et restauration, cliquez sur Effectuer une sauvegarde.
Dans la page Effectuer une sauvegarde Étape 1 de 2 : sélectionner un composant à sauvegarder, sélectionnez Solutions, puis cliquez sur Suivant.

Vous pouvez également sélectionner une solution spécifique, si vous ne souhaitez en sauvegarder qu’une seule.
Dans la page Démarrer la sauvegarde Étape 2 de 2 : sélectionner les options de sauvegarde, dans la section Type de sauvegarde, sélectionnez Complète ou Différentielle.

Notes

Si vous sauvegardez la solution pour la première fois, vous devez utiliser l’option Complète. Vous devez effectuer une sauvegarde complète avant de pouvoir effectuer une sauvegarde différentielle.
Dans la section Emplacement des fichiers de sauvegarde , tapez le chemin d’accès UNC (Universal Naming Convention) du dossier de sauvegarde, puis cliquez sur Démarrer la sauvegarde.
Vous pouvez afficher l’état général de tous les travaux de sauvegarde en haut de la page État des opérations de sauvegarde et de restauration, dans la section Disponibilité. Vous pouvez afficher l’état de la tâche de sauvegarde actuelle dans la partie inférieure de la page, dans la section Sauvegarde. 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 sauvegarde peut prendre plusieurs secondes.

Si des messages d'erreur s'affichent, traitez-les 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 Spbackup.log situé à l'emplacement indiqué à l'étape 4.

Pour sauvegarder des solutions approuvées à l’aide de PowerShell

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 ;
- 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, consultez Add-SPShellAdmin.
Démarrez SharePoint Management Shell.
À l'invite de commandes PowerShell, tapez la commande suivante pour sauvegarder toutes les solutions de la batterie. Pour sauvegarder une seule solution, ajoutez son nom au chemin d'accès de l'élément « farm\solutions ».
```
Backup-SPFarm -backupmethod full -directory <UNC location> -item "farm\solutions"
```
Où :
- <UNC location> est l'emplacement UNC du répertoire où vous stockez le fichier de sauvegarde.

Pour plus d'informations, voir Backup-SPFarm.

Notes

[!REMARQUE] Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L’outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Sauvegarder des solutions bac à sable (sandbox) dans SharePoint Server

Vous ne pouvez pas sauvegarder uniquement des solutions en bac à sable. Au lieu de cela, vous devez sauvegarder la batterie, l’application Web ou la base de données de contenu à laquelle est associée la solution bac à sable (sandbox).

Sauvegarder des éléments de site créés dans SharePoint Server

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

Sauvegarder des flux de travail dans SharePoint Server

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

Les flux de travail déclaratifs, tels que ceux qui ont été 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 sauvegarde de la base de données de contenu protège 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.
- Fichiers de définition XML (. Les fichiers ACTIONS) sont stockés dans le répertoire 16\TEMPLATE<LCID>\Workflow.
- Une entrée XML pour marquer 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 de serveurs utilisent des actions personnalisées, vous devez recourir à un système de sauvegarde de fichiers pour protéger ces fichiers et les entrées XML. S'apparentant à des fonctionnalités telles que les composants WebPart et les récepteurs d'événements, ces fichiers doivent être réappliqués à la batterie 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, sont stockés à deux emplacements. Les assemblys Visual Studio pour le flux de travail sont stockés dans le GAC, et les fichiers de définition XML sont stockés dans le répertoire Features. Il s’agit de la même chose que d’autres types de fonctionnalités SharePoint 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, la sauvegarde de la batterie, de l’application Web, de la base de données de contenu ou de la collection de sites protège ce flux de travail.
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 sauvegarder les deux collections de sites afin de protéger le flux de travail. Cela comprend les flux de travail qui écrivent dans un historique ou autre liste personnalisée dans une autre collection de sites. Une sauvegarde de batterie suffit à sauvegarder toutes les collections de site de la batterie et tous les flux de travail qui y sont associés.
Les workflows qui ne sont pas encore déployés doivent être sauvegardés et restaurés séparément. Lorsque vous développez un nouveau flux de travail mais que vous ne l’avez pas encore déployé sur la batterie de serveurs SharePoint Server, veillez à sauvegarder le dossier dans lequel vous stockez les fichiers projet de flux de travail par une application de sauvegarde du système de fichiers.

Sauvegarder des modifications apportées au fichier Web.config dans SharePoint Server

L'une des personnalisations courantes de SharePoint Server consiste à modifier le fichier Web.config. Il est vivement recommandé de modifier ce fichier à l'aide de l'Administration centrale ou des API et du modèle objet SharePoint Server. Ces modifications étant stockées dans la base de données de configuration, elles peuvent être récupérées à partir d'une sauvegarde de batterie ou de type configuration uniquement.

Les modifications apportées au fichier Web.config qui ne sont pas effectuées à l’aide de l’Administration centrale ou des API sharePoint Server et du modèle objet doivent être protégées à l’aide d’une sauvegarde du système de fichiers.

Notes

[!REMARQUE] Si vous avez recours à l'authentification basée sur les formulaires, l'inscription du fournisseur dans le fichier Web.config est manuelle et n'est pas protégée par la sauvegarde SharePoint Server. Dans ce cas, assurez-vous que vous sauvegardez le fichier Web.config par une sauvegarde de système de fichiers.

Sauvegarder des produits tiers dans SharePoint Server

Si des produits tiers sont déployés en tant que packages de solution, ils sont protégés par la sauvegarde SharePoint Server. Nous vous recommandons de conserver tous les fichiers d’origine, supports de distribution, documentation et clés de produits et de licence nécessaires à l’installation.

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

La sauvegarde des personnalisations développées qui ne sont pas déployées en tant que packages de solution peut être un processus complexe, car les emplacements des fichiers de personnalisation peuvent ne pas être stockés dans des emplacements standardisés et SharePoint Server ne les sauvegarde pas automatiquement.

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 sauvegarder ces répertoires avec une solution de sauvegarde de système de fichiers. Le tableau suivant répertorie les emplacements où les personnalisations développées sont généralement stockées sur les serveurs web.

Emplacement	Description
%PROGRAMFILES%\Common files\Microsoft Shared\Web Server Extensions\16	Fichiers fréquemment mis à jour, assemblys personnalisés, modèles personnalisés, définitions de sites personnalisées.
Inetpub	Emplacement des répertoires virtuels Services Internet (IIS)
%WINDIR%\Assembly	Global Assembly Cache (GAC) : emplacement protégé du système d’exploitation où les assemblys de code .NET Framework sont installés pour fournir un accès système complet.