Get-SPEnterpriseSearchQueryScopeRule

  • Referência
Módulo:
SharePointServer
Aplica-se a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Retorna uma regra de escopo compartilhada.

Syntax

Get-SPEnterpriseSearchQueryScopeRule
   [[-Identity] <ScopeRulePipeBind>]
   -Scope <ScopePipeBind>
   [-Url <Uri>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [<CommonParameters>]

Description

O cmdlet Get-SPEnterpriseSearchQueryScopeRule lê um objeto QueryScopeRule quando a regra de escopo compartilhada é criada, atualizada ou excluída. SPEnterpriseSearchQueryScopeRule representa uma regra de escopo de resultado que pode ser aplicada a um escopo.

No SharePoint Server, as fontes de resultado fornecem a funcionalidade que os escopos fornecidos no SharePoint Server.

Durante uma atualização do SharePoint Server, para manter as configurações herdadas, os escopos compartilhados são migrados automaticamente. No entanto, esses escopos são somente leitura após a migração. Esse cmdlet pode ser usado para ler uma regra de escopo de um escopo compartilhado que foi migrado.

Durante uma atualização do SharePoint Server, para preservar as configurações herdadas, os escopos locais também são migrados automaticamente quando os sites ou coleções de sites correspondentes são migrados. Em um farm do SharePoint Server, os escopos de um site ou coleção de sites que está no modo do SharePoint Server são de leitura-gravação, enquanto os escopos de um site ou coleção de sites após a atualização para o modo do SharePoint Server são somente leitura. Esse cmdlet pode ser usado para ler uma regra de escopo de um escopo local migrado em qualquer situação.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

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

$ssa = Get-SPEnterpriseSearchServiceApplication -Identity 'Search Service Application'
$scope = Get-SPEnterpriseSearchQueryScope -Identity MustCrawl -SearchApplication $ssa
Get-SPEnterpriseSearchQueryScopeRule -Scope $scope -Url https://criticalSite | Set-SPEnterpriseSearchQueryScopeRule -Url https://criticalSite -UrlScopeRuleType Url

Este exemplo obtém uma referência a uma regra de escopo para a URL https://criticalSitee define seu tipo de regra como URL.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. 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 após o uso para 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 forem usados.

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Especifica a regra de escopo a ser obtida.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de uma regra de escopo (por exemplo, ScopeRule1) ou uma instância de um objeto ScopeRule válido.

Type:ScopeRulePipeBind
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Scope

Retorna regras de escopo de consulta para o escopo especificado.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um escopo (por exemplo, Scope1) ou uma instância de um objeto Scope válido.

Type:ScopePipeBind
Aliases:n
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

Especifica o aplicativo de pesquisa que contém a coleção de regras de escopo 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

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Url

O tipo deve ser uma URL válida, no formulário https://server_name.

Retorna regras de escopo de consulta para a URL de resultados especificada.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019