Restore-SPEnterpriseSearchServiceApplication

 

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2015-03-09

Restaura o backup de um aplicativo de pesquisa feito por terceiros.

Syntax

Restore-SPEnterpriseSearchServiceApplication [-Name] <String> -AdminSearchServiceInstance <SearchServiceInstancePipeBind> -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> -DatabaseName <String> -DatabaseServer <String> [-AdminApplicationPool <SPIisWebServiceApplicationPoolPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DatabasePassword <SecureString>] [-DatabaseUsername <String>] [-FailoverDatabaseServer <String>] [-WhatIf [<SwitchParameter>]]

Restore-SPEnterpriseSearchServiceApplication [-Name] <String> -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> -TopologyFile <String> [-AdminApplicationPool <SPIisWebServiceApplicationPoolPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-KeepId <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Restore-SPEnterpriseSearchServiceApplication é usado por terceiros para criar um aplicativo de pesquisa que use dados existentes.

Terceiros fazem backup dos dados do aplicativo e precisam restaurá-lo mais tarde. Dessa forma, os dados são restaurados e o cmdlet Restore-SPEnterpriseSearchServiceApplication é usado para criar um novo aplicativo de pesquisa que utilize os dados restaurados.

Esse cmdlet dá suporte a conjuntos de parâmetros. O primeiro conjunto de parâmetros é para o modo Anexo de Configuração de Aplicativo e o segundo conjunto de parâmetros é para o modo Anexo de Aplicativo de Pesquisa.

O modo Anexo de Configuração de Aplicação só restaura dados de configuração armazenados no banco de dados de administração. No entanto, o Anexo de Aplicativo de Pesquisa restaura dados de configuração, de topologia e todos os dados rastreados.

Parameters

Conjunto de Parâmetros 1

Parâmetro	Obrigatório	Tipo	Descrição
Name	Obrigatório	System.String	Especifica o nome do novo aplicativo de pesquisa.
ApplicationPool	Obrigatório	Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind	Especifica o pool de aplicativos para o serviço Web de consulta.
AdminApplicationPool	Opcional	Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind	Especifica o pool de aplicativos para o serviço Web administrativo.
AdminSearchServiceInstance	Opcional	Microsoft.Office.Server.Search.Cmdlet.SearchServiceInstancePipeBind	Especifica a instância de serviço de pesquisa a ser usada com o componente de administração.
AssignmentCollection	Opcional	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	Gerencia objetos para a finalidade de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos depois que for necessário liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não é usado. Observação Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
Confirm	Opcional	System.Management.Automation.SwitchParameter	Solicita sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters
DatabaseName	Opcional	System.String	Especifica o nome do banco de dados a ser criado para a restauração do aplicativo de pesquisa. O tipo deve ser um nome válido de um banco de dados do SQL Server; por exemplo, RestoreDB1.
DatabasePassword	Opcional	System.String	Especifica o nome da senha para o servidor de banco de dados no Microsoft SQL Server.
DatabaseServer	Opcional	System.String	Especifica o nome do servidor host para o banco de dados especificado em DatabaseName. O tipo deve ser um nome de host de SQL Server válido; por exemplo, SQLServerHost1.
DatabaseUsername	Opcional	System.String	Especifica o nome da conta especificada no parâmetro Database Server.
FailoverDatabaseServer	Opcional	System.String	Use esse parâmetro se quiser que o banco de dados de administração utilize um servidor de banco de dados de failover.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Parameters

Conjunto de parâmetros 2

Parâmetro	Obrigatório	Tipo	Descrição
ApplicationPool	Obrigatório	Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind	Especifica o pool de aplicativos para o serviço Web de consulta.
TopologyFile	Obrigatório	System.String	Especifica o caminho para o arquivo .XML que contém as informações sobre a topologia do aplicativo.
AdminApplicationPool	Opcional	Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind	Especifica o pool de aplicativos para o serviço Web administrativo.
AssignmentCollection	Opcional	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	Gerencia objetos para a finalidade de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos depois que for necessário liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não é usado. Observação Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
Confirm	Opcional	System.Management.Automation.SwitchParameter	Solicita sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Tipos de entrada

Tipos de retorno

Example

------------------EXEMPLO 1------------------

$searchInstance = Get-SPEnterpriseSearchServiceInstance -local
$applicationPool = New-SPIisWebServiceApplicationPool -Name "SearchServiceApplicationPool"

Restore-SPEnterpriseSearchServiceApplication -Name "SearchServiceApplication" -ApplicationPool $applicationPool -AdminSearchServiceInstance $searchInstance -DatabaseName "SearchServiceApplication_Admindb" -DatabaseServer "SQLServer1"

Este exemplo usa o modo Anexo de Configuração de Aplicativo para restaurar dados de configuração.

------------------EXEMPLO 2------------------

$applicationPool = New-SPIisWebServiceApplicationPool -Name "SearchServiceApplicationPool"

Restore-SPEnterpriseSearchServiceApplication -Name "SearchServiceApplication" -ApplicationPool $applicationPool -TopologyFile "C:\TopologyFile.xml"

Este exemplo usa o modo Anexo de Aplicativo de Pesquisa para restaurar dados de topologia no arquivo denominado topology.xml.