Artigo
03/07/2017

New-SPEnterpriseSearchQueryComponent

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2015-03-09

Adiciona um componente de consulta a uma topologia de consulta.

Syntax

New-SPEnterpriseSearchQueryComponent -IndexPartition <IndexPartitionPipeBind> -QueryTopology <QueryTopologyPipeBind> -SearchServiceInstance <SearchServiceInstancePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-FailoverOnly <SwitchParameter>] [-IndexLocation <String>] [-SearchApplication <SearchServiceApplicationPipeBind>] [-ShareName <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet New-SPEnterpriseSearchQueryComponent é usado quando a funcionalidade de pesquisa é inicialmente configurada e um novo componente de consulta é adicionado a um aplicativo de pesquisa compartilhado. Uma topologia de consulta tem uma ou mais partições de índice e um ou mais componentes de consulta. Componentes de consulta executam pesquisa de termo de texto completo gerado por consulta de usuário em partições de índice.

Para saber mais sobre permissões e obter as informações mais recentes sobre cmdlets de pesquisa, consulte a documentação online (https://go.microsoft.com/fwlink/?LinkId=163185).

Parameters

Parâmetro	Obrigatório	Tipo	Descrição
IndexPartition	Obrigatório	Microsoft.Office.Server.Search.Cmdlet.IndexPartitionPipeBind	Especifica a partição de índice a ser usada para o componente de consulta. O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh ou uma instância de um objeto IndexPartition válido.
QueryTopology	Obrigatório	Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind	Especifica a topologia de pesquisa que contém a coleção de componentes de consulta. O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh ou uma instância de um objeto QueryTopology válido.
SearchServiceInstance	Obrigatório	Microsoft.Office.Server.Search.Cmdlet.SearchServiceInstancePipeBind	Especifica a instância de serviço de pesquisa que hospedará o novo componente de consulta. O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um servidor de consulta, no formato MeuServidordeConsulta ou uma instância de um objeto SearchServiceInstance válido.
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
FailoverOnly	Opcional	System.Management.Automation.SwitchParameter	Especifica se o componente de consulta será usado para failover.
IndexLocation	Opcional	System.String	Especifica o caminho para o diretório de índice onde os arquivos de índice de texto completo são criados. O tipo deve ser um caminho válido em um dos seguintes formatos: - C:\ nome_da_pasta - \\nome_do_servidor\nome_da_pasta
SearchApplication	Opcional	Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind	Especifica o aplicativo de pesquisa que contém a topologia de consulta. O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome de aplicativo de pesquisa válido (por exemplo, SearchApp1) ou uma instância de um objeto SearchServiceApplication válido.
ShareName	Opcional	System.String	Especifica o nome para o compartilhamento de arquivos no caminho especificado em IndexLocation. A cadeia de caracteres deve conter somente caracteres válidos em um caminho UNC. O tipo deve ser um nome válido de um compartilhamento de arquivos; por exemplo, FileShare1.
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------------------

$ssa = GetSPEnterpriseSearchServiceApplication
$qtOld = $ssa | Get-SPEnterpriseSearchQueryTopology -Active
$ssInstance = Get-SPEnterpriseSearchServiceInstance -Local
$qtNew = $ssa | New-SPEnterpriseSearchQueryTopology -Partitions 1 
$idxPartition = (Get-SPEnterpriseSearchIndexPartition -QueryTopology $qtOld)
$queryComponent = New-SPEnterpriseSearchQuerycomponent -QueryTopology $qtNew -IndexPartition $idxPartition -SearchServiceInstance $ssInstance
$qtNew | Set-SPEnterpriseSearchQueryTopology -Active
$qtOld | Remove-SPEnterpriseSearchQueryTopology

Este exemplo cria uma topologia de consulta com uma única partição e cria um componente de consulta para essa topologia. Em seguida, define a topologia de consulta recém-criada como a topologia de consulta ativa de um aplicativo de pesquisa denominado MySSA e exclui a topologia antiga.

Compartilhar via