Restore-SPEnterpriseSearchServiceApplication

Ripristina il backup di terze parti di un'applicazione di ricerca.

Sintassi

Restore-SPEnterpriseSearchServiceApplication
       [-Name] <String>
       -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
       -AdminSearchServiceInstance <SearchServiceInstancePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       -DatabaseName <String>
       [-DatabasePassword <SecureString>]
       -DatabaseServer <String>
       [-DatabaseUsername <String>]
       [-FailoverDatabaseServer <String>]
       [-WhatIf]
       [<CommonParameters>]
Restore-SPEnterpriseSearchServiceApplication
       [-Name] <String>
       -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-KeepId]
       [-WhatIf]
       -TopologyFile <String>
       [-DeferUpgradeActions]
       [<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.

Questo cmdlet viene utilizzato da terze parti per creare un'applicazione di ricerca che utilizza dati esistenti.

In alcuni casi, le terze parti eseguono il backup dei dati dell'applicazione e devono ripristinare l'applicazione in un secondo momento. I dati vengono quindi ripristinati e usano il Restore-SPEnterpriseSearchServiceApplication cmdlet per creare una nuova applicazione di ricerca che usa i dati ripristinati.

Questo cmdlet supporta i set di parametri.

Il primo set di parametri è per la modalità di associazione della configurazione dell'applicazione e il secondo set di parametri è per la modalità di associazione dell'applicazione di ricerca.

La modalità di associazione della configurazione dell'applicazione consente di ripristinare unicamente i dati di configurazione archiviati nel database di amministrazione. La modalità di associazione dell'applicazione di ricerca consente invece di ripristinare la configurazione, la topologia e tutti i dati sottoposti a ricerca per indicizzazione.

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

$searchInstance = Get-SPEnterpriseSearchServiceInstance -local
$applicationPool = New-SPServiceApplicationPool -Name "SearchServiceApplicationPool" -Account "domain\username"
Restore-SPEnterpriseSearchServiceApplication -Name "SearchServiceApplication" -ApplicationPool $applicationPool -AdminSearchServiceInstance $searchInstance -DatabaseName "SearchServiceApplication_Admindb" -DatabaseServer "SQLServer1"

In questo esempio viene utilizzata la modalità di associazione della configurazione dell'applicazione per ripristinare i dati di configurazione.

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

$applicationPool = New-SPServiceApplicationPool -Name "SearchServiceApplicationPool" -Account "domain\username"
Restore-SPEnterpriseSearchServiceApplication -Name "SearchServiceApplication" -ApplicationPool $applicationPool -TopologyFile "C:\TopologyFile.xml"

In questo esempio viene utilizzata la modalità di associazione dell'applicazione di ricerca per ripristinare i dati della topologia nel file topology.xml.

Parametri

-AdminSearchServiceInstance

Specifica l'istanza del servizio di ricerca che verrà utilizzata con il nuovo componente di amministrazione.

Type:SearchServiceInstancePipeBind
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

-ApplicationPool

Specifica il pool di applicazioni per il servizio Web di query.

Type:SPIisWebServiceApplicationPoolPipeBind
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

-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

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

-DatabaseName

Specifica il nome del database da creare per il ripristino dell'applicazione di ricerca.

Il tipo deve essere un nome valido di un database SQL Server, ad esempio RestoreDB1.

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

-DatabasePassword

Specifica il nome della password per il server di database nel SQL Server.

Type:SecureString
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 nome del server host del database specificato in DatabaseName.

Il tipo deve essere un nome host SQL Server valido, ad esempio SQLServerHost1.

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

-DatabaseUsername

Specifica il nome account per il server di database specificato nel parametro DatabaseServer.

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

-DeferUpgradeActions

Impedisce l'aggiornamento dello schema del database durante il ripristino. Non utilizzare.

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

-FailoverDatabaseServer

Specificare questo parametro se si desidera che il database di amministrazione utilizzi un server di database di failover.

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

-KeepId

Specifica se l'ID applicazione del servizio di ricerca della topologia .xml file deve essere usato per l'applicazione del servizio di ricerca ripristinata.

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

-Name

Specifica il nome della nuova applicazione di ricerca.

Type:String
Position:1
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

-TopologyFile

Specifica il percorso del file con estensione xml che contiene le informazioni della topologia dell'applicazione.

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

-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