Restore-SPFarm

Riferimento

Modulo:: SharePointServer

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

Ripristina uno o più elementi da un backup.

Sintassi

Restore-SPFarm
       -Directory <String>
       -RestoreMethod <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-FarmCredentials <PSCredential>]
       [-Force]
       [-Item <String>]
       [-NewDatabaseServer <String>]
       [-Percentage <Int32>]
       [-RestoreThreads <Int32>]
       [-WhatIf]
       [<CommonParameters>]

Restore-SPFarm
       -Directory <String>
       [-ShowTree]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-Item <String>]
       [-WhatIf]
       [<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-SPFarm cmdlet ripristina uno o più elementi da un backup, ad esempio un singolo database, un'applicazione Web o l'intera farm. È inoltre possibile utilizzare questo cmdlet per applicare un modello di farm all'intera farm.

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

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

Questo esempio consente di ripristinare nella farm le impostazioni di configurazione dal pacchetto di backup nella directory \\file_server\share\Backup.

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

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

Questo esempio consente di visualizzare i componenti della farm che verrebbero ripristinati nel nodo Microsoft SharePoint Foundation Web Application senza tuttavia eseguirne effettivamente il ripristino.

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

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

Questo esempio consente di ripristinare una farm utilizzando 10 thread senza visualizzazione dell'avviso per overwrite.

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

-BackupId

Specifica il GUID del pacchetto di backup da ripristinare. A ogni pacchetto di backup è associato un GUID univoco. Il GUID può essere visualizzato usando il Get-SPBackupHistory cmdlet per visualizzare la cronologia dei backup. Se non si specifica questo parametro, verrà utilizzato il pacchetto di backup più recente disponibile nel percorso specificato con il parametro Directory.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890abcdef.

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

-ConfigurationOnly

Specifica che solo le impostazioni, e non i dati, verranno ripristinate dal pacchetto di backup e applicate agli oggetti nella farm di destinazione.

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

-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

-Directory

Specifica il percorso in cui i prodotti SharePoint hanno archiviato il pacchetto di backup. Se si dispone di un computer in cui sono installati SQL Server e un'istanza di Prodotti SharePoint, è possibile usare i percorsi di unità locali. Ciò è valido anche per un'installazione di base. Tuttavia, se SQL Server e Prodotti SharePoint sono installati in più computer, è necessario usare i percorsi di condivisione UNC (Universal Naming Convention) in modo che i prodotti SQL Server e SharePoint possano leggere dalla stessa posizione, ad esempio \\computer_name \volume\Backup.

Il tipo deve essere uno dei percorsi validi seguenti:

C:\nome_cartella
\\server_name\folder_name

Le cartelle spbr * vengono create automaticamente.

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

-FarmCredentials

Specifica le credenziali che verranno usate per tutti i componenti da ripristinare. Ad esempio, le credenziali del pool di applicazioni per le applicazioni Web da ripristinare. Se nella farm esiste già un pool di applicazioni da ripristinare, le credenziali specificate dal parametro FarmCredentials vengono ignorate durante il ripristino del pool di applicazioni.

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

-Force

Evita la visualizzazione del prompt di avviso per la sovrascrittura di componenti, quando si esegue un'operazione di ripristino con sovrascrittura.

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

-Item

Indica la parte del pacchetto di backup da ripristinare. È possibile utilizzare la notazione con percorso completo della farm, come visualizzato dal parametro ShowTree, oppure il nome del componente di destinazione nel percorso, se tale nome è univoco. Se vi sono più elementi con lo stesso nome, sarà necessario specificare il percorso completo. Racchiudere l'elemento o il percorso tra virgolette se contiene uno spazio. Se non specifica questo parametro, verrà ripristinato l'intero pacchetto di backup.

Il tipo deve essere un elemento valido, come:

Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80

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

-NewDatabaseServer

Specifica un nome di server di database SQL Server valido. Se si specifica questo parametro, il valore verrà utilizzato come nome di server di database predefinito per tutti i database nell'operazione di ripristino.

Questo parametro è valido solo quando si esegue il ripristino come nuovo. Non è valido per i ripristini di sovrascrittura.

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

-Percentage

Richiede che gli aggiornamenti dello stato relativi all'operazione di ripristino vengano visualizzati in incrementi di tale percentuale. Ad esempio, un valore pari a 5 visualizza gli aggiornamenti dello stato di avanzamento del ripristino ogni 5% completati e un valore pari a 10 visualizza gli aggiornamenti dello stato di ripristino ogni 10% completati.

Nota: lo stato verrà visualizzato nell'output solo se si specifica il parametro Verbose. In caso contrario, è possibile controllare lo stato nel file di registro del ripristino.

Questa percentuale non è precisa e gli aggiornamenti dello stato effettivi potrebbero essere inferiori o superiori a quanto richiesto.

Per un database molto grande, il valore consigliato è 1.

Il tipo deve essere un valore intero compreso tra 1 e 100.

Il valore predefinito è 5.

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

-RestoreMethod

Specifica il metodo di ripristino da eseguire.

I valori validi sono:

Nuovo; Specifica un nuovo percorso per ripristinare il contenuto e deve essere usato durante il ripristino in una farm diversa. Verranno visualizzate altre richieste per specificare le nuove impostazioni.
Sovrascrivere; Ripristina il contenuto e le impostazioni nei percorsi originali e deve essere usato durante il ripristino nella stessa farm da cui è stato eseguito il backup. Se viene usato il parametro Overwrite, viene visualizzata una richiesta di conferma. Se si vuole eliminare la richiesta di conferma, usare il parametro Force.

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

-RestoreThreads

Numero di thread da utilizzare durante il ripristino.

Minore è il numero di thread per il ripristino, più semplice sarà interpretare il registro di ripristino. Con un maggior numero di thread di ripristino, tuttavia, sarà possibile ripristinare più componenti in parallelo con tempi di esecuzione del ripristino potenzialmente più rapidi.

L'intervallo valido è compreso tra 1 e 10. Il valore predefinito è 3.

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

-ShowTree

Visualizza gli oggetti nella farm che verranno ripristinati in base agli altri parametri passati al Restore-SPFarm cmdlet, ovvero i parametri Item e ConfigurationOnly. Gli elementi che verranno esclusi dal ripristino in base agli altri parametri passati al Restore-SPFarm cmdlet verranno preceduti da un asterisco (*). Gli elementi che non possono essere ripristinati verranno racchiusi tra parentesi quadre ([ ]). Non verrà eseguita un'operazione di ripristino se è presente il parametro ShowTree.

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

-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