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.