Compartilhar via


Get-SPEnterpriseSearchQueryTopology

 

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2015-03-09

Retorna uma topologia de consulta.

Syntax

Get-SPEnterpriseSearchQueryTopology [[-Identity] <QueryTopologyPipeBind>] -SearchApplication <SearchServiceApplicationPipeBind> [-Active <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>]

Descrição detalhada

O cmdlet Get-SPEnterpriseSearchQueryTopology lê um objeto QueryTopology quando a topologia de consulta é criada, atualizada ou excluída.

Se o parâmetro Identity não for especificado, esse cmdlet retornará a coleção de topologias de consulta de um farm para o aplicativo de pesquisa especificado.

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

Identity

Opcional

Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind

Especifica a topologia de consulta a ser obtida.

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.

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.

Active

Opcional

System.Management.Automation.SwitchParameter

Filtra para retornar somente as topologias de consulta ativas. Uma topologia de consulta ativa é aquela que atualmente serve consultas para o aplicativo de pesquisa.

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.

Tipos de entrada

Tipos de retorno

Example

------------------EXEMPLO------------------

$queryTopology$searchapp = Get-SPEnterpriseSearchServiceApplication -"SearchApp1" 
$qtopo = Get-SPEnterpriseSearchQueryTopology -SearchApplication MySSA$searchapp -Active

Este exemplo recupera a topologia de consulta ativa de um aplicativo de pesquisa denominado SearchApp1.