Compartilhar via


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.