Backup-SPFarm
Crée une sauvegarde d'une base de données individuelle, d'une application web ou de la batterie de serveurs entière.
Syntax
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Backup-SPFarm
[-ShowTree]
[-AssignmentCollection <SPAssignmentCollection>]
[-ConfigurationOnly]
[-Item <String>]
[-WhatIf]
[-Confirm]
[<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-SPFarm crée une sauvegarde de la batterie de serveurs entière ou de composants individuels de la batterie de serveurs. Elle permet également de sauvegarder uniquement les paramètres de configuration d'une batterie de serveurs à utiliser comme modèle de batterie de serveurs pour d'autres batteries de serveurs SharePoint. Pour sauvegarder une seule collection de sites, utilisez l’applet de commande Backup-SPSite.
Pour afficher les objets disponibles à sauvegarder, utilisez le jeu de -ShowTree paramètres .
Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.
Exemples
--------------------EXEMPLE 1---------------------
Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnlyCet exemple sauvegarde les paramètres de configuration de la batterie de serveurs dans le répertoire \\serveur_fichiers\share\Backup.
--------------------EXEMPLE 2---------------------
Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -VerboseCet exemple montre quels composants de la batterie de serveurs seraient sauvegardés sous le nœud « Microsoft SharePoint Foundation Web Application », sans toutefois les sauvegarder.
--------------------EXEMPLE 3---------------------
Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -ForceCet exemple effectue une sauvegarde d'une batterie de serveurs en utilisant 10 threads et forcer l'enregistrement de la sauvegarde dans le répertoire C:\Backup même si SharePoint estime que l'espace disponible est insuffisant.
--------------------EXAMPLE 4---------------------
Backup-SPFarm -ShowTreeCet exemple montre les objets disponibles à sauvegarder avec Backup-SPFarm.
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 |
-BackupMethod
Spécifie le type de fichier de sauvegarde à créer.
Si une sauvegarde est effectuée avec le paramètre -ShowTree, le paramètre BackupMethod n’est pas utilisé.
Une sauvegarde complète est une sauvegarde de toutes les données sélectionnées. Une sauvegarde différentielle est une sauvegarde de toutes les données sélectionnées ayant changé depuis la dernière sauvegarde complète. Si un élément ne prend pas en charge la sauvegarde différentielle, une sauvegarde complète est alors exécutée sur cet élément.
Le type doit être l'une des valeurs suivantes :
- Complet
- Différentiel
| 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 |
-BackupThreads
Spécifie le nombre de threads à utiliser lors de la sauvegarde. Moins il y a de threads, plus le fichier journal de la sauvegarde est facile à lire et à comprendre. Plus il y a de threads, plus vous pouvez sauvegarder de composants en parallèle, ce qui peut entraîner une sauvegarde plus rapide. La valeur minimale est 1 et la valeur maximale est 10.
La valeur par défaut est 3.
Si une sauvegarde est effectuée avec le paramètre -ShowTree, le paramètre BackupMethod n’est pas utilisé.
| Type: | Int32 |
| 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 |
-ConfigurationOnly
Lorsque ce paramètre est spécifié, la sauvegarde contient uniquement des paramètres de configuration (aucune donnée) pour chacun des objets à sauvegarder.
SharePoint peut surestimer la quantité d’espace nécessaire pour une sauvegarde de configuration uniquement, ce qui peut entraîner l’estimation de SharePoint qu’il ne dispose pas de suffisamment d’espace pour stocker la sauvegarde au chemin d’accès spécifié. Dans ce cas, utilisez le -Force paramètre pour poursuivre la sauvegarde si vous disposez de suffisamment d’espace pour stocker la sauvegarde de configuration uniquement.
| Type: | SwitchParameter |
| 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 |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| 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 |
-Force
Spécifie la poursuite de l'opération de sauvegarde même si l'estimation indique que le répertoire de sauvegarde ne dispose pas de l'espace suffisant pour contenir la sauvegarde entière.
Si une sauvegarde a lieu avec le paramètre ShowTree, alors le paramètre Force n'est pas utilisé.
| Type: | SwitchParameter |
| 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 |
-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 le composant a un nom unique. S'il existe plusieurs éléments correspondants, le chemin d'accès complet doit être spécifié. Par défaut, le nœud supérieur est sélectionné. Placez l'élément ou le chemin d'accès entre guillemets s'il contient un espace. Si ce paramètre n'est pas spécifié, toute la batterie de serveurs est sauvegardée.
Le type doit être un élément valide ; par exemple, Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80.
| 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 |
-Percentage
Demande l'affichage des mises à jour de l'avancement de l'opération de sauvegarde en incréments égaux à ce pourcentage, par exemple la valeur 5 affiche l'avancement de la sauvegarde par palier de 5 %, et la valeur 10, l'avancement de la sauvegarde par palier de 10 %. Pour afficher les résultats, vous devez spécifier le paramètre Verbose.
Ce pourcentage n'est pas précis et l'avancement réel de l'opération peut être supérieur ou inférieur aux valeurs définies. Les mises à jour de progression sont toujours enregistrées dans le fichier journal de sauvegarde.
La valeur du pourcentage n’est pas précise et l’avancement réel de l’opération peut être supérieur ou inférieur aux valeurs définies.
La valeur par défaut est 5. Pour une base de données très volumineuse, 1 est la valeur recommandée.
Les valeurs valides sont un nombre entier compris entre 1 et 100.
| Type: | Int32 |
| 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 Backup-SPFarm, à 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-SPFarm 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 |
-WhatIf
Affiche un message qui explique l’effet de la commande au lieu de l’exécuter.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| 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 |