Ripristinare le personalizzazioni in SharePoint Server

SI APPLICA A:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

È possibile ripristinare qualsiasi personalizzazione apportata a SharePoint Server tramite Amministrazione centrale o PowerShell. Lo strumento di ripristino utilizzato dipende dal tipo di ambiente distribuito, dalle esigenze della pianificazione e dai contratti di servizio stipulati con l'organizzazione.

Prima di iniziare

Prima di iniziare questa attività, analizzare le informazioni seguenti:

• È consigliabile conservare un backup del file con estensione wsp originale oltre che del codice sorgente utilizzato per creare il file con estensione wsp sia per le soluzioni attendibili che per le soluzioni in modalità sandbox.

Ripristino dei pacchetti delle soluzioni in SharePoint Server

Il metodo utilizzato per eseguire il ripristino dei pacchetti delle soluzioni varia a seconda che le personalizzazioni siano state distribuite come soluzioni attendibili o soluzioni in modalità sandbox.

Le soluzioni attendibili sono soluzioni distribuite da amministratori di farm. Vengono distribuiti nella farm completa e possono essere usati in qualsiasi sito all'interno della farm. Le soluzioni attendibili vengono archiviate nel database di configurazione. Il backup di soluzioni attendibili viene eseguito quando viene eseguito il backup di una farm tramite il backup di SharePoint Server e sono incluse nei backup di sola configurazione e può essere eseguito anche come gruppo o singolarmente. Sono visibili nella gerarchia di ripristino.

Le soluzioni in modalità sandbox sono soluzioni che possono essere distribuite dagli amministratori di raccolte siti in una singola raccolta siti. Sono archiviate nel database del contenuto associato alla raccolta siti in cui vengono distribuite. Vengono incluse nei backup delle applicazioni Web, del database del contenuto, delle raccolte siti e delle farm di SharePoint Server, ma non sono visibili nella gerarchia di ripristino e non possono essere selezionate o ripristinate singolarmente.

Per ripristinare una soluzione attendibile tramite Amministrazione centrale

1. Verificare che l'account utente che esegue questa procedura sia membro del gruppo di SharePoint Amministratori farm.

2. Avviare Amministrazione centrale.

3. Nella home page di Amministrazione centrale fare clic su Ripristina da backup nella sezione Backup e ripristino.

4. Nella pagina Ripristina da backup - Passaggio 1 di 3: Selezione backup da ripristinare selezionare nell'elenco dei backup il processo di backup contenente il pacchetto della soluzione e quindi fare clic su Avanti. È possibile visualizzare ulteriori dettagli su ogni backup facendo clic sul segno più (+) accanto al backup.

   Nota

   Se il processo di backup desiderato non è elencato, digitare il percorso UNC (Universal Naming Convention) della cartella dei backup corretta nella casella di testo Percorso directory di backup e quindi fare clic su Aggiorna.

5. Nella pagina Ripristina da backup - Passaggio 2 di 3: Selezione componenti da ripristinare selezionare la casella di controllo accanto alla soluzione e quindi fare clic su Avanti.

6. Nella sezione Ripristina componente della pagina Ripristina da backup - Passaggio 3 di 3: Selezione opzioni di ripristino verificare che nell'elenco Ripristina il componente seguente sia presente Soluzione.

   Nella sezione Ripristina solo impostazioni di configurazione verificare che l'opzione Ripristina contenuto e impostazioni di configurazione sia selezionata.

   Nella sezione Opzioni di ripristino in Tipo di ripristino selezionare l'opzione Stessa configurazione. Viene visualizzata una finestra di dialogo che chiede di confermare l'operazione. Fare clic su OK.

   Fare clic su Avvia ripristino.

7. È possibile visualizzare lo stato generale di tutti i processi di ripristino nella parte superiore della pagina Stato processo di backup e ripristino, nella sezione Disponibilità. È possibile visualizzare lo stato del processo di ripristino corrente nella parte inferiore della pagina, nella sezione Ripristino. La pagina dello stato viene aggiornata automaticamente ogni 30 secondi. È possibile aggiornare manualmente i dettagli relativi allo stato facendo clic su Aggiorna. Il backup e il ripristino sono processi del servizio timer. È pertanto possibile che siano necessari alcuni secondi di attesa per l'avvio del ripristino.

   Nella colonna Messaggio di errore della pagina Stato processo di backup e ripristino è possibile rivedere eventuali errori restituiti. È possibile trovare ulteriori dettagli nel file Sprestore.log disponibile nel percorso UNC specificato al passaggio 3.

Per ripristinare una soluzione attendibile tramite PowerShell

1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

   • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

   • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

   • Gruppo Administrators per il server in cui vengono eseguiti i cmdlet diPowerShell.

     Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

   Nota

   [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'installazione o all'amministratore di SQL Server. Per ulteriori informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

3. Al prompt dei comandi di PowerShell digitare il comando seguente:

   Restore-SPFarm -Directory <BackupFolder> -RestoreMethod Overwrite -BackupId <GUID> -Item <SolutionPath>
   

   Dove:

   • <BackupFolder> è il percorso UNC della directory a partire dalla quale si desidera effettuare il ripristino.

   • <GUID> è il GUID dell'ID di backup in base al quale si desidera effettuare il ripristino. Se non si specifica un backup, verrà utilizzato quello più recente.

   • <SolutionPath> è il percorso della soluzione all'interno dell'albero di backup (in genere farm\solutions\ SolutionName).

Per ulteriori informazioni, vedere Restore-SPFarm.

Ripristino di una soluzione in modalità sandbox

Non è possibile ripristinare solo le personalizzazioni distribuite come soluzioni in modalità sandbox. È necessario invece ripristinare la farm, l'applicazione Web, il database del contenuto o la raccolta siti a cui è associata la personalizzazione.

Ripristino degli elementi dei siti creati in SharePoint

Non è possibile ripristinare solo gli elementi dei siti creati. È necessario invece ripristinare la farm, l'applicazione Web o il database del contenuto a cui è associato l'elemento del sito.

Ripristino dei flussi di lavoro in SharePoint

I flussi di lavoro costituiscono un caso speciale di personalizzazioni di cui è possibile eseguire il ripristino. Verificare che nel piano di backup e ripristino siano inclusi gli scenari seguenti in base all'ambiente:

• I flussi di lavoro dichiarativi, come quelli creati in SharePoint Designer, vengono archiviati nel database del contenuto per la raccolta siti in cui vengono distribuiti. Eseguendo il ripristino del database del contenuto o della raccolta siti vengono ripristinati anche questi flussi di lavoro.

• Le azioni personalizzate dei flussi di lavoro dichiarativi hanno componenti nelle tre posizioni seguenti:

  • Gli assembly di Visual Studio 2013 per le azioni sono archiviati nella Global Assembly Cache (GAC).

  • I file di definizione XML (file con estensione actions) vengono archiviati nella directory 16\TEMPLATE<LCID>\Workflow.

  • Una voce XML per contrassegnare l'azione come tipo autorizzato è archiviata nel file Web.config per le applicazioni in cui viene utilizzata.

    Se nei flussi di lavoro della farm vengono utilizzate azioni personalizzate, è consigliabile utilizzare un sistema di ripristino dei file per ripristinare questi file e le voci XML. È quindi possibile riapplicare i file dopo il ripristino a seconda delle esigenze.

• I flussi di lavoro che dipendono da codice personalizzato, ad esempio quelli creati utilizzando Visual Studio 2013, vengono archiviati in due posizioni. Gli assembly di Visual Studio 2013 per il flusso di lavoro vengono archiviati nella GAC, mentre i file di definizione XML vengono archiviati nella directory Features. Questo comportamento è analogo ad altri tipi di caratteristiche di SharePoint Server, ad esempio le Web part e i ricevitori di eventi. Se il flusso di lavoro è stato installato nell'ambito di un pacchetto della soluzione, seguire le istruzioni relative al ripristino dei pacchetti delle soluzioni.

• Se si crea un flusso di lavoro personalizzato che interagisce con una raccolta siti diversa da quella in cui è distribuito il flusso di lavoro, è necessario ripristinare entrambe le raccolte siti per ripristinare il flusso di lavoro. Il ripristino di una farm è sufficiente per ripristinare tutte le raccolte siti della farm e tutti i flussi di lavoro a esse associati.

• I flussi di lavoro non distribuiti devono essere ripristinati separatamente utilizzando un'applicazione di backup del file system.

Ripristino delle modifiche apportate al file Web.config in SharePoint Server

È possibile ripristinare le modifiche apportate al file Web.config tramite il modello a oggetti e le API di Amministrazione centrale o SharePoint Server eseguendo un ripristino della farm o solo della configurazione.

È consigliabile utilizzare un backup del file system per proteggere le modifiche apportate al file Web.config non tramite il modello a oggetti e le API di SharePoint o Amministrazione centrale. È possibile ripristinare il backup ripristinando il file system.

Ripristino delle personalizzazioni sviluppate non incluse in pacchetti delle soluzioni in SharePoint Server

Il ripristino delle personalizzazioni sviluppate non inserite in pacchetti come soluzioni può essere un processo complesso poiché i percorsi dei file di personalizzazione non sono standardizzati.

Consultare il team di sviluppo o il fornitore delle personalizzazioni per determinare se le personalizzazioni prevedono file o software di componenti aggiuntivi in altri percorsi. È consigliabile ripristinare le directory con una soluzione di ripristino del file system. Nella tabella seguente vengono elencati i percorsi in cui vengono in genere archiviate le personalizzazioni nei server Web.

Vedere anche

Concetti

Eseguire il backup delle personalizzazioni in SharePoint Server

Ripristinare le farm in SharePoint Server

Ripristinare le configurazioni delle farm in SharePoint Server

Ripristinare le applicazioni Web in SharePoint Server

Ripristinare database del contenuto in SharePoint Server

Ripristinare le raccolte siti in SharePoint Server