Backup-SPFarm

Crea un backup di un singolo database, una singola applicazione Web o l'intera farm.

Sintassi

Backup-SPFarm
      -BackupMethod <String>
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-BackupThreads <Int32>]
      [-ConfigurationOnly]
      [-Force]
      [-Item <String>]
      [-Percentage <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-SPFarm
      [-ShowTree]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-ConfigurationOnly]
      [-Item <String>]
      [-WhatIf]
      [-Confirm]
      [<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-SPFarm crea un backup per l'intera farm o per singoli componenti nella farm. Può inoltre essere utilizzato per eseguire un backup delle sole impostazioni di configurazione di una farm da utilizzare come modello di farm per altre farm di SharePoint. Se si desidera eseguire il backup di una singola raccolta siti, utilizzare il cmdlet Backup-SPSite.

Per visualizzare gli oggetti disponibili di cui eseguire il backup, usare il -ShowTree set di parametri.

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

Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnly

Questo esempio consente di eseguire il backup delle impostazioni di configurazione della farm nella directory \\file_server\share\Backup.

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

Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -Verbose

Questo esempio consente di visualizzare i componenti della farm di cui verrebbe eseguito il backup nel nodo "Microsoft SharePoint Foundation Web Application" senza tuttavia eseguirne effettivamente il backup.

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

Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -Force

Questo esempio consente di eseguire un backup di una farm utilizzando 10 thread e forza il salvataggio del backup nella directory C:\Backup anche se lo spazio disponibile viene stimato come insufficiente da SharePoint.

--------------------EXAMPLE 4---------------------

Backup-SPFarm -ShowTree

Questo esempio illustra gli oggetti disponibili di cui eseguire il backup con Backup-SPFarm.

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

-BackupMethod

Specifica il tipo di file di backup da creare.

Se viene eseguito un backup con il parametro -ShowTree, il parametro BackupMethod non viene usato.

Con il valore Full viene eseguito un backup completo, ovvero comprendente tutti i dati selezionati. Con il valore Differential viene eseguito un backup differenziale, ovvero comprendente tutti i dati selezionati che sono stati modificati dopo l'esecuzione dell'ultimo backup completo. Se un elemento non supporta il backup differenziale, per tale elemento verrà eseguito un backup completo.

Il tipo deve essere uno dei valori seguenti:

  • Full
  • Differenziale
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

-BackupThreads

Specifica il numero di thread da utilizzare durante il backup. Minore è il numero di thread, più facile sarà leggere e comprendere il file di registro del backup. Maggiore è il numero di thread, più sono i componenti di cui è possibile eseguire il backup in parallelo, con una conseguente velocizzazione potenziale dell'operazione di backup. Il valore minimo è 1 e quello massimo è 10.

Il valore predefinito è 3.

Se viene eseguito un backup con il parametro -ShowTree, il parametro BackupMethod non viene usato.

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

-ConfigurationOnly

Se si imposta questo parametro il backup conterrà solo le impostazioni di configurazione (senza dati) per ognuno degli oggetti inclusi nel backup.

SharePoint potrebbe sovrastimare la quantità di spazio necessaria per un backup di sola configurazione, il che potrebbe comportare la stima di SharePoint che non dispone di spazio sufficiente per archiviare il backup nel percorso specificato. Usare il -Force parametro in questa situazione per procedere con il backup se si dispone di spazio sufficiente per archiviare il backup solo configurazione.

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

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

-Force

Specifica di continuare l'operazione di backup anche se le stime indicano che lo spazio disponibile nella directory di backup non è sufficiente per contenere l'intero backup.

Se si esegue un backup con il parametro ShowTree, il parametro Force non viene utilizzato.

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 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. Per impostazione predefinita, viene selezionato il nodo principale. Racchiudere l'elemento o il percorso tra virgolette se contiene uno spazio. Se non si specifica questo parametro, verrà eseguito il backup dell'intera farm.

Il tipo deve essere un elemento valido; Ad esempio, Farm\Microsoft Applicazione Web SharePoint Foundation\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

-Percentage

Richiede gli aggiornamenti dello stato dell'operazione di backup da visualizzare in incrementi di tale percentuale; Ad esempio, un valore pari a 5 visualizza gli aggiornamenti dello stato di avanzamento del backup ogni 5% completati e un valore pari a 10 visualizza gli aggiornamenti dello stato di avanzamento del backup ogni 10% completati. Per visualizzare gli output di avanzamento, è necessario specificare il parametro Verbose.

Questa percentuale non è precisa e gli aggiornamenti dello stato effettivi potrebbero essere inferiori o superiori a quanto richiesto. Gli aggiornamenti dello stato vengono sempre registrati nel file di registro del backup.

Il valore di percentuale non è preciso e gli aggiornamenti dello stato effettivi potrebbero essere inferiori o superiori a quanto richiesto.

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

Il valore valido è un numero intero compreso tra 1 e 100.

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 della farm di cui verrà eseguito il backup sulla base degli altri parametri passati al cmdlet Backup-SPFarm, specificamente del parametro Item. Gli elementi che verranno esclusi dal backup sulla base degli altri parametri passati al cmdlet Backup-SPFarm 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

-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