Backup-SPConfigurationDatabase

Référence

Module:: SharePointServer

S’applique à:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Effectue une sauvegarde de la configuration au niveau de la batterie de serveurs.

Syntax

Backup-SPConfigurationDatabase
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [<CommonParameters>]

Backup-SPConfigurationDatabase
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [-ShowTree]
      [<CommonParameters>]

Description

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez les Jeux de paramètres des applets de commande.

L’applet de commande Backup-SPConfigurationDatabase effectue une sauvegarde de la configuration seule de la batterie de serveurs actuelle ou une sauvegarde de la configuration seule d’une base de données de configuration distincte qui n’est pas reliée à la batterie de serveurs actuelle. Pour effectuer une sauvegarde de la configuration seulement de la batterie de serveurs actuelle, vous ne devez pas spécifier les paramètres DatabaseServer et DatabaseName. Toutefois, l’utilisation de l’applet de commande Backup-SPFarm avec le paramètre ConfigurationOnly est recommandée pour un tel scénario.

Exemple de sauvegarde de la configuration : un administrateur crée un modèle de configuration de batterie de serveurs qu’il peut ensuite appliquer à d’autres batteries de serveurs SharePoint en effectuant une restauration via l’applet de commande Restore-SPFarm.

Pour obtenir les autorisations et les informations les plus actuelles sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne à l’adresse https://go.microsoft.com/fwlink/p/?LinkId=251831.

Exemples

-------------------EXEMPLE 1--------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -ShowTree

Cet exemple affiche les composants pouvant être inclus dans une sauvegarde de la configuration.

-------------------EXEMPLE 2--------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -Verbose

Cet exemple effectue une sauvegarde de la configuration avec commentaires.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseCredentials

Spécifie l'ID et le mot de passe correspondant au nom d'utilisateur de l'administrateur de la base de données SQL Server.

Ce paramètre ne doit être spécifié que si la connexion à la base de données repose sur l'authentification SQL. En revanche, si elle repose sur l'authentification Windows, ce paramètre ne doit pas être spécifié.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

Spécifie le nom de la base de données de configuration.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Spécifie le serveur de base de données SQL qui contient la base de données de configuration. Il s'agit par défaut du nom de l'ordinateur local.

Le type doit être un serveur de base de données valide, par exemple DS.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Directory

Spécifie le chemin d’accès où les produits SharePoint stockent le package de sauvegarde qu’ils génèrent. Si vous avez un ordinateur sur lequel SQL Server et une instance de produits SharePoint sont installés, vous pouvez utiliser des chemins d’accès de lecteur local. Ceci implique une installation de base. Toutefois, si SQL Server et les produits SharePoint sont installés sur plusieurs ordinateurs ou si vous avez plusieurs serveurs exécutant des produits SharePoint, vous devez utiliser des chemins d’accès de partage UNC (Universal Naming Convention) afin que les composants de base de données et de recherche SQL Server soient écrits au même emplacement, par exemple\ \\computer_name\volume\Backup).

Plusieurs packages de sauvegarde peuvent être stockés au même emplacement. Il s'agit du chemin d'accès que vous passez au paramètre Directory de l'applet de commande Restore-SPFarm.

Le type doit être l'un des chemins d'accès valides suivants :

C:\nom_dossier
\\server_name\folder_name

Les dossiers spbr* sont créés automatiquement.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Item

Indique la partie de la batterie de serveurs à sauvegarder. Vous pouvez utiliser la notation du chemin d'accès complet à la batterie de serveurs, tel qu'il est affiché par le paramètre ShowTree, ou le nom du composant cible dans le chemin d'accès, si son nom est unique. Si plusieurs éléments ont le même nom, le chemin d'accès complet doit être spécifié. Placez l'élément ou le chemin d'accès entre guillemets s'il contient un espace.

Si le paramètre Item n'est pas spécifié, la configuration de la batterie de serveurs entière est sauvegardée.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ShowTree

Indique les objets de la batterie de serveurs qui seront sauvegardés en fonction des autres paramètres passés à l'applet de commande de sauvegarde, à savoir le paramètre Item. Les éléments qui seront exclus de la sauvegarde en fonction des autres paramètres passés à l'applet de commande Backup-SPConfigurationDatabase seront précédés d'un astérisque (*). Les éléments qui ne peuvent pas être sauvegardés seront placés entre crochets ([ ]). La sauvegarde n'a pas lieu si le paramètre ShowTree est spécifié.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019