Restore-SPSite

 

Sapplique à :SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

Dernière rubrique modifiée :2016-10-17

Restaure une collection de sites.

Restore-SPSite [-Identity] <String> -Path <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-ContentDatabase <SPContentDatabasePipeBind>] [-Force <SwitchParameter>] [-GradualDelete <SwitchParameter>] [-HostHeaderWebApplication <String>] [-PreserveSiteID <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Restore-SPSite [-Identity] <String> -Path <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DatabaseName <String>] [-DatabaseServer <String>] [-Force <SwitchParameter>] [-GradualDelete <SwitchParameter>] [-HostHeaderWebApplication <String>] [-PreserveSiteID <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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, voir la rubrique relative aux jeux de paramètres de cmdlet.

L’applet de commande Restore-SPSite restaure la collection de sites à l’emplacement spécifié par le paramètre Identity. Une base de données de contenu ne peut contenir qu’une seule copie d’une collection de sites. Si une collection de sites est sauvegardée et restaurée sur une URL différente au sein de la même application web, une base de données de contenu supplémentaire doit être disponible pour contenir la copie restaurée de la collection de sites.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

System.String

Spécifie l’URL sur laquelle la collection de sites est restaurée.

Il n’est pas nécessaire que la collection de sites existe déjà sur l’URL pour effectuer la restauration. Toutefois, vous devez spécifier une URL valide dans laquelle la collection de sites peut être créée. Si une collection de sites existe déjà à l’URL spécifiée, vous devez spécifier le paramètre Force pour l’écraser.

Le type doit être une URL valide au format http://server_name/sites/nom_site.

Path

Obligatoire

System.String

Spécifie un chemin d’accès valide vers l’emplacement de la sauvegarde. Par exemple, C:\Backup\nom_site.bak.

AssignmentCollection

Facultatif

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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.

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

Confirm

Facultatif

System.Management.Automation.SwitchParameter

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

ContentDatabase

Facultatif

Microsoft.SharePoint.PowerShell.SPContentDatabasePipeBind

Spécifie la base de données de contenu SQL Server dans laquelle les données de la collection de sites seront stockées. Si aucune base de données de contenu n’est spécifiée, la base de données de contenu la plus disponible et dont le statut est prêt est utilisée.

DatabaseName

Facultatif

System.String

Spécifie la base de données de contenu SQL Server dans laquelle les données de la collection de sites seront stockées. Si aucune base de données de contenu n’est spécifiée, la base de données de contenu la plus disponible et dont le statut est prêt est utilisée.

Le type doit correspondre à un nom de base de données valide au format SQLDB1.

DatabaseServer

Facultatif

System.String

Spécifie le nom du serveur SQL Server contenant la base de données de contenu spécifiée par le paramètre DatabaseName.

Le type doit correspondre à un nom de serveur de base de données valide au format SQLBE1 et doit être utilisé avec le paramètre DatabaseName.

Force

Facultatif

System.Management.Automation.SwitchParameter

Spécifie que la collection de sites existante à l’URL doit être écrasée par cette restauration.

GradualDelete

Facultatif

System.Management.Automation.SwitchParameter

Spécifie que la collection de sites écrasée par le paramètre Force doit être graduellement supprimée dans le temps par un travail du minuteur plutôt qu’en une seule fois, ce qui réduit son impact sur la performance des produits SharePoint 2010 et SQL Server. Cette option est recommandée pour les collections de sites volumineuses.

HostHeaderWebApplication

Facultatif

System.String

URL valide associée à l’application web par le biais d’un mappage des accès de substitution tel que http://nom_serveur.

Restaure une collection de sites sous la forme d’une collection de sites nommée par l’hôte, et non sous la forme d’une collection reposant sur des chemins d’accès. Lorsque le paramètre HostHeaderWebApplication est spécifié, la valeur du paramètre Identity correspond à l’URL de la collection de sites nommée par l’hôte et la valeur du paramètre HostHeaderWebApplication correspond à l’URL de l’application web qui contiendra la collection de sites nommée par l’hôte.

PreserveSiteID

Facultatif

System.Management.Automation.SwitchParameter

Conserve les informations d’ID de site du fichier de sauvegarde.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

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

Restore-SPSite http://server_name/sites/site_name -Path C:\Backup\site_name.bak

Cet exemple restaure une collection de sites à partir du fichier de sauvegarde C:\Backup\site_name.bak vers l’URL de la collection de sites http://server_name/sites/site_name.

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

Restore-SPSite http://server_name/sites/site_name -Path C:\Backup\site_name.bak -Force -DatabaseServer SQLBE1 -DatabaseName SQLDB1

Cet exemple restaure une sauvegarde d’une collection de sites à partir du fichier de sauvegarde C:\Backup\site_name.bak, mais remplace la collection de sites existante à l’adresse http://server_name/sites/site_name en spécifiant qu’elle doit être restaurée dans une base de données de contenu spécifique.

------------------EXEMPLE 3-----------------------

Restore-SPSite http://www.example.com -Path \\file_server\share\site_name.bak -HostHeaderWebApplication http://server_name

Cet exemple restaure une sauvegarde d’une collection de sites à partir du fichier de sauvegarde \\file_server\share\site_name.bak vers la collection de sites nommée par l’hôte http://www.example.com sur l’application web http://server_name.

Afficher: