New-SPEnterpriseSearchQueryScope
Aplica-se a: SharePoint Server 2010
Tópico modificado em: 2015-03-09
Adiciona um escopo de resultados da consulta a um aplicativo de pesquisa compartilhado.
Syntax
New-SPEnterpriseSearchQueryScope [-Name] <String> -Description <String> -DisplayInAdminUI <Nullable> -SearchApplication <SearchServiceApplicationPipeBind> [-AlternateResultsPage <String>] [-AssignmentCollection <SPAssignmentCollection>] [-CompilationType <Nullable>] [-Confirm [<SwitchParameter>]] [-ExtendedSearchFilter <String>] [-OwningSiteUrl <Uri>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Use o cmdlet New-SPEnterpriseSearchQueryScope para criar um novo escopo compartilhado. SPEnterpriseSearchQueryScope representa um escopo de resultados da consulta usado por todos os aplicativos de pesquisa compartilhados no farm.
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 |
---|---|---|---|
Name |
Obrigatório |
System.String |
Especifica a identidade do escopo a ser criado. O tipo deve ser um nome válido de um escopo (por exemplo, Scope1). |
Descrição |
Obrigatório |
System.String |
Adiciona uma descrição do novo escopo de consulta. O tipo deve ser uma cadeia de caracteres válida; por exemplo, uma descrição de um escopo de consulta. |
DisplayInAdminUI |
Obrigatório |
System.Nullable |
Especifica que o novo escopo será exibido na interface do usuário do aplicativo de administração. A configuração padrão é ocultar o novo escopo na interface do usuário do aplicativo de administração. |
SearchApplication |
Obrigatório |
Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind |
Especifica o aplicativo de pesquisa que contém a coleção de escopos 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. |
AlternateResultsPage |
Obrigatório |
System.String |
Especifica o local onde serão exibidos os resultados do novo escopo de consulta. O tipo deve ser uma URL válida, no formato http://nome_do_servidor. |
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. |
CompilationType |
Opcional |
System.Nullable |
Especifica o tipo de compilação do novo escopo. O valor 0 especifica o tipo de escopo compilado condicionalmente e o valor 1 especifica o tipo de escopo sempre compilado. O tipo deve ser um dos seguintes: 0 ou 1. |
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 |
OwningSiteUrl |
Opcional |
System.Uri |
Especifica o site do SharePoint associado ao novo escopo. O tipo deve ser uma URL de site do SharePoint válida, no formato http://nome_do_servidor. |
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 = Get-SPEnterpriseSearchServiceApplication -Identity MySSA
$ssa | New-SPEnterpriseSearchQueryScope -Name MustCrawl -Description "Sites we must crawl" -DisplayInAdminUI $true
Este exemplo adiciona um escopo denominado MustCrawl
que será exibido na interface do usuário de administração para o aplicativo de serviço de pesquisa denominado MySSA
.