Partager via

Restore-SPSite

Module:
SharePointServer module

Restaure une collection de sites.

Syntaxe

DatabaseFromPipebind 

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

DatabaseParameter 

Restore-SPSite
    [-Identity] <String>
    -Path <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DatabaseName <String>]
    [-DatabaseServer <String>]
    [-Force]
    [-GradualDelete]
    [-HostHeaderWebApplication <String>]
    [-WhatIf]
    [-PreserveSiteID]
    [<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-SPSite de commande effectue une restauration de la collection de sites à un 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 à un autre emplacement d’URL dans 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.

Exemples

EXEMPLE 1

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

Cet exemple montre comment restaurer une collection de sites à partir du fichier de sauvegarde C :\Backup\site_name.bak dans l’URL de la collection de sites https://server_name/sites/site_name.

EXEMPLE 2

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

Cet exemple montre comment restaurer une sauvegarde de collection de sites à partir du fichier de sauvegarde C :\Backup\site_name.bak, mais remplacer la collection de sites existante sur https://server_name/sites/site_name tout en spécifiant que la collection de sites doit être stockée dans une base de données de contenu spécifique.

EXEMPLE 3

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

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

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

-Confirm

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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
Alias:cf

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

-ContentDatabase

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SPContentDatabasePipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DatabaseFromPipebind
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseName

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

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

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

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

DatabaseParameter
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GradualDelete

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie que la collection de sites remplacée par le paramètre Force doit être supprimée progressivement au fil du temps par un travail du minuteur au lieu de tout en même temps, ce qui réduit son impact sur les produits SharePoint et les performances SQL Server. Cette option est recommandée pour les collections de sites volumineuses.

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

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-HostHeaderWebApplication

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

URL valide affectée à l’application web à l’aide d’un mappage d’accès alternatif, par exemple https://server_name

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.

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

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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 https://server_name/sites/site_name.

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:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PreserveSiteID

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Conserve l’ID de site d’origine au lieu d’en créer un nouveau.

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

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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
Alias:Wi

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

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.