Backup-SPSite
Effectue une sauvegarde d'une collection de sites.
Syntaxe
Default (Par défaut)
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 récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.
Exemples
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 en mode lecture seule pendant la sauvegarde.
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 |
-Force
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le remplacement d'un fichier de sauvegarde s'il existe déjà.
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 |
-Identity
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SPSitePipeBind |
| 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 |
-NoSiteLock
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 dont le paramètre de verrouillage est « Aucun » ou « Aucun ajout » sera temporairement définie sur « Lecture seule » pendant l'opération de sauvegarde. 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.
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 |
-Path
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le chemin d'accès complet au fichier de sauvegarde (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: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UseABSDocStreamInfo
Applicable : SharePoint Server 2016, SharePoint Server 2019
Ne pas utiliser.
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 |
-UseSqlSnapshot
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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.