Backup-SPConfigurationDatabase

Esegue un backup solo della configurazione a livello di farm.

Sintassi

Backup-SPConfigurationDatabase
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [<CommonParameters>]
Backup-SPConfigurationDatabase
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [-ShowTree]
      [<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 cmdlet Backup-SPConfigurationDatabase esegue un backup solo della configurazione della farm corrente oppure di un database di configurazione separato, non collegato alla farm corrente. Se si desidera eseguire un backup solo della configurazione della farm corrente, non è necessario specificare i parametri DatabaseServer e DatabaseName. Tuttavia, per questo scenario è consigliabile usare il cmdlet Backup-SPFarm con il parametro ConfigurationOnly.

Un esempio di backup della configurazione è rappresentato da un amministratore che crea un modello di configurazione della farm applicabile in seguito ad altre farm di SharePoint tramite l'esecuzione di un ripristino con il cmdlet Restore-SPFarm.

Per le autorizzazioni e le informazioni più aggiornate sulle Windows PowerShell per i prodotti SharePoint, vedere la documentazione online all'indirizzo https://go.microsoft.com/fwlink/p/?LinkId=251831.

Esempio

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

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -ShowTree

Questo esempio consente di visualizzare i componenti disponibili per l'inclusione in un backup solo della configurazione.

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

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -Verbose

Questo esempio consente di eseguire un backup solo della configurazione con output dettagliato.

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

-DatabaseCredentials

Specifica l'ID e la password corrispondenti al nome utente dell'amministratore per il database di SQL Server.

Questo parametro deve essere specificato solo se si utilizza l'autenticazione di SQL Server per connettersi al database. Se si utilizza invece l'autenticazione di Windows, questo parametro non è necessario.

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

-DatabaseName

Specifica il nome del database di configurazione.

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 server di database SQL contenente il database di configurazione. Il valore predefinito corrisponde al nome del computer locale.

Il tipo deve essere un server di database valido, ad esempio SD.

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

-Directory

Specifica il percorso in cui Prodotti SharePoint archivia il pacchetto di backup generato. 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 o se sono presenti più server che eseguono prodotti SharePoint, è necessario usare i percorsi di condivisione UNC (Universal Naming Convention) in modo che il database SQL Server e i componenti di ricerca vengano scritti nello stesso percorso, ad esempio \\computer_name\volume\Backup.

Più pacchetti di backup possono essere archiviati nello stesso percorso. Si tratta dello stesso percorso passato al parametro Directory del cmdlet Restore-SPFarm.

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

-Item

Indica la parte della farm di cui eseguire il backup. È 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 si specifica il parametro Item, verrà eseguito il backup della configurazione dell'intera farm.

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

-ShowTree

Visualizza gli oggetti della farm di cui verrà eseguito il backup sulla base degli altri parametri passati al cmdlet di backup, specificamente del parametro Item. Gli elementi che verranno esclusi dal backup sulla base degli altri parametri passati al cmdlet Backup-SPConfigurationDatabase saranno preceduti dal carattere asterisco (*). Gli elementi di cui non è possibile eseguire il backup saranno racchiusi tra parentesi quadre ([ ]). Se è presente il parametro ShowTree, il backup non verrà eseguito.

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