Get-SPEnterpriseSearchQueryScopeRule
Retorna uma regra de escopo compartilhada.
Sintaxe
Default (Padrão)
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 origens de resultados fornecem a funcionalidade que os âmbitos fornecidos no SharePoint Server.
Durante uma atualização do SharePoint Server, para manter as definições legadas, os âmbitos partilhados 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 definições legadas, os âmbitos locais também são migrados automaticamente quando os sites ou coleções de sites correspondentes são migrados. Num farm do SharePoint Server, os âmbitos de um site ou coleção de sites que se encontra no modo sharePoint Server são de leitura/escrita, enquanto os âmbitos de uma coleção de sites ou sites após a atualização para o modo do SharePoint Server são só de 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 âmbito para o URL https://criticalSitee define o respetivo tipo de regra como URL.
Parâmetros
-AssignmentCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | ScopeRulePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Scope
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | ScopePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | n |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SearchApplication
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriedades do parâmetro
| Tipo: | SearchServiceApplicationPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Url
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
O tipo tem de ser um URL válido, no formulário https://server_name.
Retorna regras de escopo de consulta para a URL de resultados especificada.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.