Backup-SPSite

Effectue une sauvegarde d'une collection de sites.

Syntax

Backup-SPSite
      [-Identity] <SPSitePipeBind>
      -Path <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-NoSiteLock]
      [-UseSqlSnapshot]
      [-WhatIf]
      [-UseABSDocStreamInfo]
      [<CommonParameters>]

Description

L’applet de commande Backup-SPSite effectue une sauvegarde de la collection de sites lorsque le paramètre Identity est utilisé.

Par défaut, la collection de sites sera définie en lecture seule pour la durée de la sauvegarde afin de réduire le risque que l’activité utilisateur endommage la sauvegarde en cours d’opération. Si vous avez SQL Server Enterprise Edition, nous vous recommandons d’utiliser le paramètre UseSqlSnapshot qui assure une sauvegarde valide tout en permettant aux utilisateurs de continuer à lire ou à écrire dans la collection de sites pendant la sauvegarde.

Pour les autorisations et les informations les plus à jour sur Windows PowerShell pour les produits SharePoint, voir la documentation en ligne sur les applets de commande SharePoint Server.

Examples

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

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

Cet exemple sauvegarde une collection de sites située à l'adresse https://server_name/sites/site_name dans le fichier C:\Backup\nom_site.bak.

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

Get-SPSiteAdministration https://server_name/sites/site_name | Backup-SPSite -Path C:\Backup\site_name.bak

Cet exemple sauvegarde une collection de sites située à l'adresse https://server_name/sites/site_name dans le fichier C:\Backup\nom_site.bak. Le résultat est identique à l’exemple 1, mais l’opération se déroule différemment.

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

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

Cet exemple sauvegarde une collection de sites à l’aide d’instantanés de base de données afin de s’assurer de l’intégrité de la sauvegarde.

-------------------EXEMPLE 4--------------------

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

Cet exemple sauvegarde une collection de sites et empêche de placer le site en mode lecture seule pendant la phase de sauvegarde. Utilisez le paramètre-NoSiteLock lors de la sauvegarde d’un site en production où il est souhaitable de ne pas placer le site dans un mode lecture seule pendant que la sauvegarde a lieu.

Parameters

-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
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Confirmer

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Force

Spécifie le remplacement d'un fichier de sauvegarde s'il existe déjà.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Identity

Spécifie l'URL ou le GUID de la collection de sites à sauvegarder.

Par exemple, une URL valide telle que https://server_name/sites/site_name ou un GUID tel que 01234567-89ab-cdef-0123-456789abcdef.

Type:SPSitePipeBind
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-NoSiteLock

Spécifie la collection de sites à laisser en lecture/écriture pendant la sauvegarde.

Si le paramètre NoSiteLock n’est pas spécifié, une collection de sites ayant un paramètre de verrouillage de collection de sites de « None » ou « no additions » sera temporairement définie sur « lecture seule » pendant que la sauvegarde de la collection de sites est effectuée. Une fois la sauvegarde terminée, le verrou de la collection de sites revient à son état d'origine. Le package de sauvegarde enregistre l'état d'origine du verrou de la collection de sites de manière à le restaurer dans cet état.

Si des utilisateurs sont occupés à écrire dans la collection de sites pendant sa sauvegarde, il est recommandé de ne pas utiliser le paramètre NoSiteLock afin d'éviter de porter atteinte à l'intégrité de la sauvegarde.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Path

Spécifie le chemin d'accès complet au fichier de sauvegarde (C:\Backup\nom_site.bak).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-UseABSDocStreamInfo

Ne pas utiliser.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019
-UseSqlSnapshot

Spécifie qu'un instantané de la base de données SQL sera créé au début de la sauvegarde et que toutes les données de la collection de sites seront récupérées directement depuis l'instantané de la base de données. Cet instantané sera automatiquement supprimé au terme de la sauvegarde.

Il est recommandé d'utiliser le paramètre UseSqlSnapshot si le serveur de base de données qui héberge votre base de données de contenu prend en charge les instantanés de base de données tels que SQL Server Enterprise Edition et SQL Server Developer Edition. Ceci permet de s'assurer de l'intégrité de la sauvegarde tout en permettant aux utilisateurs de continuer à lire et à écrire dans la collection de sites pendant la sauvegarde. Il n'est pas nécessaire de spécifier le paramètre NoSiteLock lorsque vous spécifiez le paramètre UseSqlSnapshot.

Type:SwitchParameter
Position:Named
Default value:None
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, tapez la commande suivante :get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019