Get-SPEnterpriseSearchQueryScopeRule
Retorna uma regra de escopo compartilhada.
Sintaxe
Default (Default)
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 resultados fornecem a funcionalidade fornecida pelos escopos do 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 conjuntos de sites correspondentes são migrados. Em um farm do SharePoint Server, os escopos de um site ou conjunto de sites que está no modo SharePoint Server são de leitura/gravação, enquanto os escopos de um site ou conjunto de sites após a atualização para o modo 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
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 deve ser uma URL válida, no formato 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.