Backup-SPSite

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Esegue un backup di una raccolta siti.

Sintassi

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

Descrizione

Il cmdlet Backup-SPSite esegue un backup della raccolta siti quando si utilizza il parametro Identity.

Per impostazione predefinita, la raccolta siti verrà impostata in modalità di sola lettura per tutta la durata del backup per evitare potenziali danni al backup causati dalle attività degli utenti durante l'operazione. Se si dispone di SQL Server Enterprise Edition, è consigliabile utilizzare il parametro UseSqlSnapshot perché assicura la creazione di un backup valido e consente allo stesso tempo agli utenti di continuare a eseguire operazioni di lettura e scrittura sulla raccolta siti durante il backup.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

-------------------ESEMPIO 1--------------------

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

Questo esempio consente di eseguire il backup di una raccolta siti all'indirizzo https://server_name/sites/site_name nel file C:\Backup\site_name.bak.

-------------------ESEMPIO 2--------------------

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

Questo esempio consente di eseguire il backup di una raccolta siti all'indirizzo https://server_name/sites/site_name nel file C:\Backup\site_name.bak. Si ottiene lo stesso risultato dell'esempio 1, ma l'operazione viene eseguita in modo diverso.

-------------------ESEMPIO 3--------------------

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

Questo esempio consente di eseguire il backup di una raccolta siti utilizzando snapshot di database per assicurare l'integrità del backup.

-------------------EXAMPLE 4--------------------

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

Questo esempio esegue il backup di una raccolta siti e impedisce di inserire il sito in una modalità di sola lettura durante la fase di backup. Usare il parametro -NoSiteLock quando si esegue il backup di un sito nell'ambiente di produzione in cui è consigliabile non inserire il sito in una modalità di sola lettura durante il backup.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

Specifica di sovrascrivere un eventuale file di backup esistente.

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

-Identity

Specifica l'URL o il GUID della raccolta siti di cui eseguire il backup.

È possibile specificare ad esempio un URL valido come https://server_name/sites/site_name oppure un GUID come "01234567-89ab-cdef-0123-456789abcdef".

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

-NoSiteLock

Specifica che la raccolta siti deve rimanere disponibile in lettura e scrittura durante il backup.

Se il parametro NoSiteLock non è specificato, una raccolta siti con un'impostazione di blocco della raccolta siti "none" o "no additions" verrà temporaneamente impostata su "sola lettura" durante l'esecuzione del backup della raccolta siti. Al termine del backup, il blocco della raccolta siti tornerà allo stato originale. Il pacchetto di backup registrerà lo stato di blocco della raccolta siti originale in modo che venga ripristinato in tale stato.

Se si prevede che gli utenti eseguano operazioni di scrittura sulla raccolta siti durante il backup, non è consigliabile utilizzare il parametro NoSiteLock a causa del potenziale impatto delle attività degli utenti sull'integrità del backup.

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

-Path

Specifica il percorso completo del file di backup, ad esempio C:\Backup\nome_sito.bak.

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

-UseABSDocStreamInfo

Non utilizzare.

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

-UseSqlSnapshot

Specifica che verrà creato uno snapshot di database SQL all'avvio del backup e che tutti i dati della raccolta siti verranno recuperati direttamente dallo snapshot di database. Tale snapshot verrà eliminato automaticamente al termine del backup.

Il parametro UseSqlSnapshot è consigliato se il server di database che ospita il database del contenuto supporta snapshot di database, ad esempio in SQL Server Enterprise Edition e SQL Server Developer Edition. Ciò assicura la creazione di un backup valido consentendo allo stesso tempo agli utenti di continuare a eseguire operazioni di lettura e scrittura nella raccolta siti durante il backup. Non è necessario specificare il parametro NoSiteLock quando si utilizza il parametro UseSqlSnapshot.

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

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Condividi tramite