Backup-SPFarm

Référence

Module:: sharepoint-server

S’applique à:: SharePoint Server Subscription Edition

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 -ConfigurationOnly

Cet 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" -Verbose

Cet 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 -Force

Cet 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 -ShowTree

Cet 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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

Partager via