Backup-SPConfigurationDatabase
Effectue une sauvegarde de la configuration au niveau de la batterie de serveurs.
Syntaxe
DefaultSet
Backup-SPConfigurationDatabase
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseName <String>]
[-DatabaseServer <String>]
[-Item <String>]
[<CommonParameters>]
ShowTree
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
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SPAssignmentCollection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DatabaseCredentials
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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é.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-DatabaseName
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le nom de la base de données de configuration.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DatabaseServer
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Directory
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le chemin d’accès où les produits SharePoint stockent le package de sauvegarde qu’ils génèrent. Si vous disposez d’un ordinateur sur lequel SQL Server et un instance de produits SharePoint sont installés, vous pouvez utiliser des chemins d’accès de lecteur locaux. 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
DefaultSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Item
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ShowTree
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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é.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ShowTree
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.