Restore-SPFarm

Référence

Module:: SharePointServer

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

Restaure des éléments à partir d'une sauvegarde.

Syntax

Restore-SPFarm
       -Directory <String>
       -RestoreMethod <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-FarmCredentials <PSCredential>]
       [-Force]
       [-Item <String>]
       [-NewDatabaseServer <String>]
       [-Percentage <Int32>]
       [-RestoreThreads <Int32>]
       [-WhatIf]
       [<CommonParameters>]

Restore-SPFarm
       -Directory <String>
       [-ShowTree]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-Item <String>]
       [-WhatIf]
       [<CommonParameters>]

Description

Cette applet de commande 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 Restore-SPFarm de commande restaure un ou plusieurs éléments à partir d’une sauvegarde telle qu’une base de données individuelle, une application web ou l’ensemble de la batterie de serveurs. Cette applet de commande peut également être utilisée pour appliquer un modèle de batterie de serveurs à l’ensemble de la batterie de serveurs.

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

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

Cet exemple montre comment restaurer les paramètres de configuration du package de sauvegarde du répertoire \\file_server\share\Backup dans la batterie de serveurs.

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

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

Cet exemple montre quels composants de la batterie de serveurs seront restaurés sous le nœud Application web Microsoft SharePoint Foundation, mais ne les restaure pas réellement.

-------------------EXAMPLE 3-----------------------

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

Cet exemple montre comment restaurer une batterie de serveurs à l’aide de 10 threads et supprimer l’avertissement de remplacement.

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

-BackupId

Spécifie le GUID du package de sauvegarde à restaurer. Chaque package de sauvegarde est associé à un GUID unique. Le GUID peut être vu à l’aide de l’applet de Get-SPBackupHistory commande pour afficher l’historique des sauvegardes. Si ce paramètre n'est pas spécifié, le package de sauvegarde le plus récent du chemin d'accès spécifié avec le paramètre Directory est utilisé.

Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890abcdef.

Type:	Guid
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

-ConfigurationOnly

Spécifie uniquement les paramètres (pas les données) qui seront restaurés à partir du package de sauvegarde et appliqués aux objets de la batterie de serveurs de destination.

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

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

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 ont stocké le package de sauvegarde. 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, vous devez utiliser des chemins de partage UNC (Universal Naming Convention) afin que les SQL Server et les produits SharePoint puissent lire à partir du même emplacement (par exemple, \\computer_name \volume\Backup).

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

-FarmCredentials

Spécifie les informations d'identification utilisées pour tous les composants en cours de restauration. Par exemple, les informations d'identification du pool d'applications des applications web en cours de restauration. Si un pool d'applications restauré existe déjà dans la batterie, les informations d'identification spécifiées par le paramètre FarmCredentials sont ignorées lors de la restauration de ce pool d'applications.

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

-Force

Supprime l'avertissement indiquant que les composants seront remplacés si vous effectuez une opération de restauration avec remplacement.

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 quelle partie du package de sauvegarde doit être restaurée. 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 correspondent au nom, le chemin d'accès complet doit être spécifié. Placez l'élément ou le chemin d'accès entre guillemets doubles s'il contient un espace. Si ce paramètre n'est pas spécifié, tout le package de sauvegarde est restauré.

Le type doit être un élément valide, tel que :

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

-NewDatabaseServer

Spécifie un nom de serveur de base de données SQL valide. Si vous spécifiez ce paramètre, ce nom sera utilisé comme nom de serveur de base de données par défaut pour toutes les bases de données impliquées dans l'opération de restauration.

Ce paramètre est valide uniquement lors de la restauration en tant que nouveau. Il n’est pas valide pour les restaurations de remplacement.

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

Provoque l'affichage des mises à jour de l'avancement de l'opération de restauration par incréments du pourcentage. Par exemple, la valeur 5 provoque la mise à jour de l'avancement affiché chaque fois que l'avancement augmente de 5 % et la valeur 10 provoque la mise à jour chaque fois que l'avancement augmente de 10 %.

Remarque : La progression s’affiche uniquement dans la sortie si le paramètre -Verbose est spécifié. Sinon, vous pouvez consulter l'avancement dans le fichier journal de la restauration.

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.

Pour une base de données très volumineuse, 1 est la valeur recommandée.

Le type doit correspondre à un nombre entier compris entre 1 et 100.

La valeur par défaut est 5.

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

-RestoreMethod

Spécifie la méthode de restauration à effectuer.

Les valeurs valides sont les suivantes :

New; spécifie un nouvel emplacement pour restaurer le contenu et doit être utilisé lorsque vous restaurez vers une autre batterie. Des invites supplémentaires apparaissent pour spécifier les nouveaux paramètres.
Overwrite; restaure le contenu et les paramètres à leurs emplacements d'origine et doit être utilisé lorsque vous restaurez sur la batterie à partir de laquelle la sauvegarde a eu lieu. Si vous utilisez le paramètre Overwrite, une invite de confirmation s'affiche. Pour supprimer cette invite, utilisez le paramètre Force.

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

-RestoreThreads

Nombre de threads à utiliser pendant la restauration.

Moins il y a de threads, plus le journal de restauration est facile à comprendre. Toutefois, plus il y a de threads de restauration, plus le nombre de composants pouvant être restaurés en parallèle est élevé, entraînant potentiellement une restauration plus rapide.

La plage valide est comprise entre 1 et 10. La valeur par défaut est 3.

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

Affiche les objets de la batterie de serveurs qui seront restaurés en fonction des autres paramètres passés à l’applet Restore-SPFarm de commande, à savoir les paramètres Item et ConfigurationOnly. Les éléments qui seront exclus de la restauration en fonction des autres paramètres passés à l’applet Restore-SPFarm de commande seront précédés d’un astérisque (*). Les éléments qui ne peuvent pas être restaurés seront placés entre crochets ([ ]). L'opération de restauration 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