Restore-SPSite

Référence

Module:: sharepoint-server

S’applique à:: SharePoint Server Subscription Edition

Restaure une collection de sites.

Syntax

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

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 emplacement URL différent 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.

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.

----------------------EXAMPLE 2----------------------

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

Cet exemple restaure une sauvegarde de collection de sites à partir du fichier de sauvegarde C:\Backup\site_name.bak, mais remplace la collection de sites existante à 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.

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

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

Cet exemple montre comment restaurer 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

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

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

-ContentDatabase

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.

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

-DatabaseName

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

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

-DatabaseServer

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.

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

-Force

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

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

-GradualDelete

Spécifie que la collection de sites remplacée par le paramètre Force doit être progressivement supprimée 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.

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

-HostHeaderWebApplication

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.

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

-Identity

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.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Path

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

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

-PreserveSiteID

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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