Compartilhar via


New-SPEnterpriseSearchQueryTopology

 

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2015-03-09

Adiciona uma topologia de consulta a um aplicativo de pesquisa compartilhado.

Syntax

New-SPEnterpriseSearchQueryTopology -SearchApplication <SearchServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Clone <SwitchParameter>] [-Clone <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-QueryTopology <QueryTopologyPipeBind>] [-WhatIf [<SwitchParameter>]]

New-SPEnterpriseSearchQueryTopology -SearchApplication <SearchServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Clone <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Partitions <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet New-SPEnterpriseSearchQueryTopology é usado quando a funcionalidade de pesquisa é inicialmente configurada ou quando uma nova topologia de consulta é criada. Um aplicativo de serviço de pesquisa pode conter várias topologias de consulta quando um componente de consulta ou partição de índice é adicionado ou excluído de uma topologia.

Parameters

Parâmetro Obrigatório Tipo Descrição

SearchApplication

Obrigatório

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.

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.

Clone

Opcional

System.Management.Automation.SwitchParameter

Especifica que a nova topologia de consulta é criada pela clonagem de uma topologia de consulta existente.

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

Partitions

Opcional

System.String

Especifica o número de partições de consulta a serem usadas para a nova topologia de consulta.

O tipo deve ser uma cadeia de caracteres válida que indique um número menor ou igual a 256.

QueryTopology

Opcional

Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind

Especifica a topologia de consulta a ser clonada para a nova topologia 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.

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. Define a nova topologia de consulta como a topologia de consulta ativa de um aplicativo de serviço de pesquisa denominado MySSA e exclui a topologia antiga.