Restore-SPSite

Ripristina una raccolta siti.

Sintassi

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>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il Restore-SPSite cmdlet esegue un ripristino della raccolta siti in una posizione specificata dal parametro Identity. Un database del contenuto può includere una sola copia di una raccolta siti. Se per la raccolta siti il backup e il ripristino vengono eseguiti in un percorso URL diverso all'interno della stessa applicazione Web, dovrà essere disponibile un ulteriore database del contenuto in cui inserire la copia ripristinata della raccolta siti.

Esempio

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

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

In questo esempio viene ripristinata una raccolta siti dal file di backup C:\Backup\site_name.bak all'URL della raccolta siti https://server_name/sites/site_name.

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

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

Questo esempio ripristina un backup della raccolta siti dal file di backup C:\Backup\site_name.bak, ma sovrascrive la raccolta siti esistente in https://server_name/sites/site_name specificando che la raccolta siti deve essere archiviata in un database del contenuto specifico.

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

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

In questo esempio viene ripristinato un backup della raccolta siti dal file di backup \\file_server\share\site_name.bak alla raccolta https://www.example.com siti denominata host nell'applicazione Web https://server_name.

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

-ContentDatabase

Specifica il database del contenuto di SQL Server in cui verranno archiviati i dati della raccolta siti. Se non si specifica alcun database del contenuto, verrà utilizzato quello con la maggiore capacità inutilizzata per le raccolte siti e con stato pronto.

Type:SPContentDatabasePipeBind
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

-DatabaseName

Specifica il database del contenuto di SQL Server in cui verranno archiviati i dati della raccolta siti. Se non si specifica alcun database del contenuto, verrà utilizzato quello con la maggiore capacità inutilizzata per le raccolte siti e con stato pronto.

Il tipo deve essere un nome di database valido nel formato DBSQL1.

Type:String
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

-DatabaseServer

Specifica il nome del computer SQL Server contenente il database del contenuto specificato dal parametro DatabaseName.

Il tipo deve essere un nome di server di database valido nel formato SDSQL1 ed è necessario utilizzarlo insieme al parametro DatabaseName.

Type:String
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 che la raccolta siti esistente nel percorso URL deve essere sovrascritta dal ripristino.

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

-GradualDelete

Specifica che la raccolta siti sovrascritta con il parametro Force deve essere eliminata gradualmente nel tempo da un processo timer anziché contemporaneamente, riducendone l'impatto sui prodotti SharePoint e sulle prestazioni SQL Server. Questa soluzione è consigliata per le raccolte siti di grandi dimensioni.

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

-HostHeaderWebApplication

URL valido assegnato all'applicazione Web tramite mapping di accesso alternativo, ad esempio https://server_name

Ripristina una raccolta siti come raccolta siti con nome basato sull'host anziché come raccolta siti basata sul percorso. Quando è presente il parametro HostHeaderWebApplication, il valore del parametro Identity è l'URL della raccolta siti con nome basato sull'host e il valore del parametro HostHeaderWebApplication è l'URL dell'applicazione Web che conterrà la raccolta siti con nome basato sull'host.

Type:String
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 il percorso URL in cui viene ripristinata la raccolta siti.

Per poter eseguire un ripristino, non è necessario che esista già una raccolta siti nel percorso URL. È tuttavia necessario specificare un percorso URL valido in cui sia possibile creare una raccolta siti. Se nel percorso URL specificato esiste già una raccolta siti, sarà necessario specificare il parametro Force per sovrascriverla.

Il tipo deve essere un URL valido nel formato 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Path

Specifica un percorso valido per il backup. Ad esempio C:\Backup\nome_sito.bak.

Type:String
Position:Named
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

-PreserveSiteID

Mantiene l'ID sito originale invece di crearne uno nuovo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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