Backup-SPConfigurationDatabase
Esegue un backup solo della configurazione a livello di farm.
Sintassi
DefaultSet
Backup-SPConfigurationDatabase
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseName <String>]
[-DatabaseServer <String>]
[-Item <String>]
[<CommonParameters>]
ShowTree
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
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | SPAssignmentCollection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DatabaseCredentials
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-DatabaseName
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifica il nome del database di configurazione.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DatabaseServer
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Directory
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
DefaultSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Item
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ShowTree
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ShowTree
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.