Set-SPEnterpriseSearchResultSource

Define as propriedades de uma fonte dos resultados.

Syntax

Set-SPEnterpriseSearchResultSource
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationType <FederationAuthType>]
   [-AutoDiscover <Boolean>]
   [-Confirm]
   [-Description <String>]
   -Identity <ResultSourcePipeBind>
   [-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 atualiza as propriedades de uma fonte de resultados criado pelo usuário. Esse cmdlet dá suporte às mesmas operações de atualização compatíveis por meio da página "Gerenciar Fontes de Resultado" na Administração Central. A fonte de resultados não pode ser uma fonte interna (a fonte interna tem a propriedade BuiltIn definida como verdadeira) para qualquer operação de atualização que não seja a alteração da fonte de resultados padrão usando o parâmetro MakeDefault. 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 1---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"

Este exemplo atualiza o nome da fonte de resultado e a identidade da fonte de resultado é especificada como uma instância de origem de resultado. SearchApplication e Owner não são necessários para esta operação de atualização.

--------------------EXEMPLO 2---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"

Este exemplo atualiza a descrição da fonte de resultado e a identidade da fonte de resultado é especificada pelo nome.

Parâmetros

-AssignmentCollection

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AuthenticationType

Especifica um tipo de autenticação para a fonte de resultado. Se o parâmetro não for especificado, o valor não é alterado.

Há suporte para um conjunto específico de tipos de autenticação para cada tipo de provedor de pesquisa e, se o parâmetro não for especificado, o tipo de autenticação será padrão com base 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 no enum FederationAuthType.

Type:FederationAuthType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AutoDiscover

Especifica se deve usar a descoberta automática do ponto de extremidade do servidor exchange para a fonte de resultado.

Definir o valor para verdadeiro ($true) indica que a descoberta automática deve ser usada.

Se o parâmetro não for especificado, o valor não é alterado.

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Description

Especifica uma descrição para a fonte dos resultados.

Se o parâmetro não for especificado, o valor não é alterado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Especifica que fonte de resultados atualizar.

O tipo deve ser uma cadeia de caracteres GUID válida, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome de fonte dos resultados válido (por exemplo, "Fonte de Resultados Personalizada do SharePoint"); ou uma instância de objeto de Fonte válido.

Type:ResultSourcePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MakeDefault

Especifica se a fonte de resultado deve ser definida como fonte de resultado padrão ou não, para o escopo especificado pelo parâmetro Proprietário.

Se o parâmetro não for especificado, a fonte de resultado padrão não será alterada.

Configurar o valor para verdadeiro ($true) indica que a fonte de resultados deve ser definida como padrão.

Definir o valor como false ($false) afirma que a fonte de resultado não deve ser definida como padrão e, nesse caso, se a fonte de resultado a ser atualizada for atualmente o padrão, a fonte de resultado padrão original ("Resultados locais do SharePoint") será definida como padrão novamente.

Dica: use instância, não nome ou ID de cadeia de caracteres GUID, como Identidade ao usar Makedefault, para especificar claramente que o Proprietário deve ser usado apenas para especificar o nível em que a fonte de resultado deve ser definida como padrão (se o valor for verdadeiro) ou onde o padrão deve ser redefinido para original (se o valor for falso).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

Especifica um nome para a fonte de resultados.

Se o parâmetro não for especificado, o valor não é alterado.

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Owner

Especifica o proprietário do objeto de pesquisa que define o escopo no qual a origem de resultado correspondente esteja disponível.

Type:SearchObjectOwner
Aliases:o
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Password

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

Se o parâmetro não for especificado, o valor não é alterado.

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).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProviderId

Especifica que provedor de pesquisa usar para a fonte de resultados.

Se o parâmetro não for especificado, o valor não é alterado.

É 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).

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-QueryTemplate

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

Se o parâmetro não for especificado, o valor não é alterado.

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}.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RemoteUrl

Especifica um modelo de conexão URL para a fonte de resultados.

Se o parâmetro não for especificado, o valor não é alterado.

Deve ser definido ao usar um provedor de pesquisa que consome: Pesquisa Remota do SharePoint, Pesquisa Remota de Pessoas no SharePoint, 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

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

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SsoId

Especifica que a ID de Repositório Seguro do certificado de proxy reverso usar para se conectar à fonte dos resultados.

Se o parâmetro não for especificado, o valor não é alterado.

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UserName

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

Se o parâmetro não for especificado, o valor não é alterado.

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).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019