Backup-SPEnterpriseSearchServiceApplicationIndex

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Esegue un backup dell'indice di ricerca in un percorso di backup specificato.

Sintassi

Backup-SPEnterpriseSearchServiceApplicationIndex
      [-Phase] <Int32>
      [-SearchApplication] <SearchServiceApplication>
      [-BackupFolder] <String>
      [-BackupHandleFile] <String>
      [[-Retries] <Int32>]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-WhatIf]
      [-PeerToPeer]
      [-SpecifiedBackupHandle <String>]
      [<CommonParameters>]
Backup-SPEnterpriseSearchServiceApplicationIndex
      [-SearchApplication] <SearchServiceApplication>
      [-BackupHandleFile] <String>
      [[-Retries] <Int32>]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-WhatIf]
      [-Abort]
      [-PeerToPeer]
      [-SpecifiedBackupHandle <String>]
      [<CommonParameters>]

Descrizione

Questo cmdlet esegue un backup dell'indice di ricerca in un percorso di backup specificato. Il cmdlet deve essere eseguito in due fasi. Nella prima fase verrà eseguito un backup dei dati presenti nell'indice al momento dell'esecuzione del cmdlet di backup. Nella seconda fase verrà eseguito un backup differenziale dei dati aggiunti nell'indice dopo l'avvio della prima fase di backup dell'indice.

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

$ssa = Get-SPEnterpriseSearchServiceApplication
Backup-SPEnterpriseSearchServiceApplicationIndex -Phase 1 -SearchApplication $ssa -BackupFolder "\\backuphost\backupfolder" -BackupHandleFile "\\backuphost\backupfolder\backuphandle.txt" -Retries 3

In questo esempio viene avviato un backup Phase 1 dell'indice di ricerca per l'applicazione di ricerca predefinita e viene archiviato il backup nel percorso \\backuphost\backupfolder. Il cmdlet archivia un file di handle backuphandle.txt utilizzato dal cmdlet della seconda fase.

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

$ssa = Get-SPEnterpriseSearchServiceApplication
Backup-SPEnterpriseSearchServiceApplicationIndex -Phase 1 $ssa -BackupFolder "\\backuphost\backupfolder" -BackupHandleFile "\\backuphost\backupfolder\backuphandle.txt" -Retries 3

In questo esempio viene controllato lo stato e l'avanzamento del backup rieseguendo il cmdlet per la prima fase (Phase 1).

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

$ssa = Get-SPEnterpriseSearchServiceApplication
Backup-SPEnterpriseSearchServiceApplicationIndex -Phase 2 -SearchApplication $ssa -BackupFolder "\\backuphost\backupfolder" -BackupHandleFile "\\backuphost\backupfolder\backuphandle.txt" -Retries 3

In questo esempio viene avviata la seconda fase (Phase 2) del backup dell'indice di ricerca utilizzando lo stesso percorso di backup e lo stesso file di handle del backup utilizzato per la prima fase. È necessario sospendere l'applicazione del servizio di ricerca prima di avviare la seconda fase.

Parametri

-Abort

{{Descrizione interruzione riempimento}}

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2013, SharePoint Server 2016, SharePoint Server 2019

-BackupFolder

Percorso UNC completo in cui devono essere scritti i file di backup.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-BackupHandleFile

Specifica un handle di file per un processo di backup in corso.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 2013, SharePoint Server 2016, SharePoint Server 2019

-PeerToPeer

{{Fill PeerToPeer Description}}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Phase

Specifica la fase del processo di backup.

Type:Int32
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Retries

Numero di tentativi in caso di errore temporaneo.

Type:Int32
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

Nome dell'applicazione del servizio di ricerca di cui eseguire il backup.

Type:SearchServiceApplication
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SpecifiedBackupHandle

{{Fill SpecifiedBackupHandle Description}}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 2013, SharePoint Server 2016, SharePoint Server 2019