New-SPEnterpriseSearchResultSource

Cria uma nova fonte dos resultados.

Sintaxe

Default (Default)

New-SPEnterpriseSearchResultSource
    [-AssignmentCollection <SPAssignmentCollection>]
    [-AuthenticationType <FederationAuthType>]
    [-AutoDiscover <Boolean>]
    [-Confirm]
    [-Description <String>]
    [-MakeDefault <Boolean>]
    -Name <String>
    -Owner <SearchObjectOwner>
    [-Password <String>]
    -ProviderId <Guid>
    [-QueryTemplate <String>]
    [-RemoteUrl <String>]
    -SearchApplication <SearchServiceApplicationPipeBind>
    [-SsoId <String>]
    [-UserName <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Este cmdlet cria uma fonte de resultados. Use fontes de resultados para definir o escopo de resultados de pesquisa e federar consultas para fontes externas, como mecanismos de pesquisa na Internet. Depois de definir uma fonte de resultados, configure Web Parts de pesquisa e ações de regras de consulta para usá-la. As Fontes de Resultados agora substituem o Escopo de Resultados, que agora estão obsoletos. Este cmdlet dá suporte às mesmas operações de criação que têm suporte na página "Gerenciar Fontes de Resultados" na Administração Central, exceto as operações "Autenticação de Formulário" e "Autenticação de Cookie". 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
$owner = Get-SPEnterpriseSearchOwner -Level SSA
New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"

Este exemplo cria uma nova fonte de resultados de nível de aplicativo de serviço de pesquisa, chamada "Fonte de Resultados Personalizada do SharePoint".

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. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

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

-AuthenticationType

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o tipo de autenticação da nova fonte de resultados.

Um conjunto específico de tipos de autenticação são suportados para cada tipo de provedor de pesquisa e, se o parâmetro não for especificado, o tipo de autenticação padrão será baseado no tipo de provedor de pesquisa.

Esse cmdlet suporta o seguinte conjunto de mecanismos de autenticação e tipos correspondentes: Autenticação Padrão do SharePoint (FederationAuthType.LocalNTAuth), Autenticação Básica (FederationAuthType.SingleAccountBasicAuth - especificar Nome de Usuário e Senha), Autenticação Padrão do SharePoint Remoto (FederationAuthType.PerUserBasicAuth), Logon Único (FederationAuthType.SSO - requer a especificação de um Ssold), Anônimos (FederationAuthType.Anonymous), Autenticação Digest (FederationAuthType.SingleAccountDigest - especificar Nome de Usuário e Senha), Identidade do Pool de Aplicativos do NTLM (FederationAuthType.ApplicationPoolIdentity), Nome de Usuário e Senha do NTLM (FederationAuthType.SingleAccountNTLM - especificar Nome de Usuário e Senha).

Ao usar um provedor de Pesquisa Local/Pesquisa de Pessoas no SharePoint, o FederationAuthType.LocalNTAuth (padrão) e FederationAuthType.SingleAccountBasicAuth são suportados.

Ao usar um provedor de Pesquisa Remota/Pesquisa de Pessoas Remota no Sharepoint, o FederationAuthType.PerUserBasicAuth (padrão) e FederationAuthType.SSO são suportados.

Ao usar o provedor de pesquisa OpenSearch 1.0/1.1 , os seguintes tipos de autenticação são suportados: FederationAuthType.Anonymous (padrão), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM e FederationAuthType.ApplicationPoolIdentity.

Todos os tipos de autenticação são listados na enumeração FederationAuthType.

Propriedades do parâmetro

Tipo:FederationAuthType
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

-AutoDiscover

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica se a descoberta automática do ponto de extremidade do servidor Exchange deve ser usada para a nova fonte de resultados.

Definir o valor para verdadeiro ($true) indica que a descoberta automática deve ser usada. Se não especificada, ou definida como falsa ($false), a descoberta automática não será usada.

Aplicável somente ao usar o provedor de pesquisa do Exchange.

Propriedades do parâmetro

Tipo:Boolean
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

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

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

-Description

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a descrição da nova fonte de resultados

Propriedades do parâmetro

Tipo:String
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

-MakeDefault

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica se a nova fonte de resultados deve ser definida como padrão ou não, para o escopo especificado pelo parâmetro Owner.

Configurar o valor para verdadeiro ($true) indica que a fonte de resultados deve ser definida como padrão. Se não for especificada ou definida como falsa, a nova fonte de resultados não será definida como padrão.

Propriedades do parâmetro

Tipo:Boolean
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

-Name

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome da nova fonte de resultados.

Os nomes devem ser únicos em cada nível administrativo.

Por exemplo, duas fontes de resultado em um site não podem compartilhar um nome, mas uma em um site e uma fornecida pelo conjunto de sites podem.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Owner

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o proprietário do objeto de pesquisa que define o escopo em a fonte de resultados correspondente é criada.

Propriedades do parâmetro

Tipo:SearchObjectOwner
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:o

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Password

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica que senha de credenciais do usuário usar para se conectar à nova fonte de resultados.

Usada quando o tipo de autenticação (AuthenticationType) está definido como um tipo que consome as credenciais do usuário (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest ou FederationAuthType.SingleAccountNTLM).

Propriedades do parâmetro

Tipo:String
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

-ProviderId

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o provedor de pesquisa a ser usado pela nova fonte de resultados.

É especificado como uma Guid ou uma cadeia de caracteres GUID, que deve ser um dos seguintes:FA947043-6046-4F97-9714-40D4C113963D (Pesquisa Local do SharePoint), E4BCC058-F133-4425-8FFC-1D70596FFD33 (Pesquisa Local de Pessoas do SharePoint), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (Pesquisa Remota do SharePoint), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (Pesquisa Remota de Pessoas do SharePoint), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (Pesquisa do Exchange), 3A17E140-1574-4093-BAD6-E19CDF1C0121 (Pesquisa OpenSearch 1.0/1.1).

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-QueryTemplate

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o modelo de transformação de consulta da nova fonte de resultados.

As consultas de entrada são alteradas de acordo com o modelo, para usar este novo texto de consulta. Inclua a consulta de entrada no novo texto, usando a variável de consulta "{searchTerms}". Use-a para resultados de escopo.

Por exemplo, para retornar apenas itens do OneNote, defina o novo texto como "{searchTerms} fileextension=one". Dessa forma, uma consulta de entrada "sharepoint" se tornará "sharepoint fileextension=one". O valor padrão é {searchTerms}.

Propriedades do parâmetro

Tipo:String
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

-RemoteUrl

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o modelo de conexão URL da nova fonte de resultados.

Deve ser definido ao usar um provedor de pesquisa que o consuma: Remote SharePoint Search, Remote SharePoint People Search, OpenSearch 1.0/1.1 e Exchange (se a Descoberta Automática não estiver ativada).

Ao usar outros provedores de pesquisa, o parâmetro é ignorado.

Para a Pesquisa Remota do SharePoint e a Pesquisa Remota de Pessoas no SharePoint, especifique o endereço do conjunto de sites raiz do farm do SharePoint remoto.

Para o OpenSearch 1.0/1.1, especifique a URL da fonte de OpenSearch.

Inclua a consulta no URL usando a variável de consulta "{searchTerms}", que será substituído automaticamente. Para o Exchange, especifique a URL do Exchange EWS do qual recuperar resultados.

Propriedades do parâmetro

Tipo:String
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

-SearchApplication

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o aplicativo de pesquisa.

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:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SsoId

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a ID do Repositório Seguro do certificado de proxy reverso a ser usada para se conectar à nova fonte de resultados.

Deve ser especificado se o tipo de autenticação (AuthenticationType) estiver definido como FederationAuthType.SSO (Logon Único).

Se a conexão intranet for feita através de um proxy reverso, digite a ID de SSO da entrada de Logon Único que armazena o certificado usado para autenticação no proxy reverso.

Propriedades do parâmetro

Tipo:String
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

-UserName

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica que nome e credenciais do usuário usar para se conectar à nova fonte de resultados.

Usado quando o tipo de autenticação (AuthenticationType) está definido como um tipo que consome as credenciais do usuário (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest ou FederationAuthType.SingleAccountNTLM).

Propriedades do parâmetro

Tipo:String
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

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

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.