Compartilhar via


New-SPEnterpriseSearchResultSource

Cria uma nova fonte dos resultados.

Sintaxe

Default (Padrão)

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 suporta as mesmas operações de criação que são suportadas através da página "Gerir Origens de Resultados" na Administração Central, exceto as operações "Autenticação de Formulário" e "Autenticação de Cookies". 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 origem de resultados ao nível da aplicação do serviço de pesquisa, denominada "Origem 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 estão listados no enum 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 pretende utilizar a deteção automática do ponto final do servidor Exchange para a nova origem 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 especificado ou definido como falso, a nova origem de resultados não será definida como predefiniçã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 fornecedor de pesquisa a ser utilizado pela nova origem 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 devolver 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.

Tem de ser definido ao utilizar um fornecedor de pesquisa que o consuma: Pesquisa Remota do SharePoint, Pesquisa remota do SharePoint Pessoas Search, OpenSearch 1.0/1.1 e Exchange (se a Deteção 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 tem de ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome de aplicação 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 o ID de Arquivo Seguro do certificado de proxy inverso a utilizar para ligar à nova origem 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 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.