Compartilhar via


Set-SPEnterpriseSearchResultSource

Define as propriedades de uma fonte dos resultados.

Sintaxe

Default (Padrão)

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. Este cmdlet suporta as mesmas operações de atualização que são suportadas através da página "Gerir Origens de Resultados" 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 origem de resultados e a identidade da origem de resultados é especificada como uma instância de origem de resultados. O SearchApplication e o Proprietário 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 origem de resultados e a identidade da origem de resultados é especificada pelo nome.

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 um tipo de autenticação para a origem de resultados. Se o parâmetro não for especificado, o valor não é alterado.

É suportado um conjunto específico de tipos de autenticação para cada tipo de fornecedor de pesquisa e, se o parâmetro não for especificado, o tipo de autenticação será predefinido com base no tipo de fornecedor 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 origem de resultados.

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.

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 uma descrição para a fonte dos resultados.

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

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

-Identity

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

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.

Propriedades do parâmetro

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

-MakeDefault

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

Especifica se a origem de resultados deve ou não ser definida como origem de resultados predefinida para o âmbito especificado pelo parâmetro Proprietário.

Se o parâmetro não for especificado, a origem de resultados predefinida 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 falso ($false) indica que a origem de resultados não deve ser predefinida e, neste caso, se a origem de resultados a atualizar for atualmente a predefinição, a origem de resultados predefinida original ("Resultados locais do SharePoint") será novamente definida como predefinida.

Sugestão: utilize a instância, não o nome ou o ID da cadeia GUID, como Identidade ao utilizar Makedefault, para especificar claramente que o Proprietário só deve ser utilizado para especificar o nível em que a origem de resultados deve ser definida como predefinição (se o valor for verdadeiro) ou onde a predefinição deve ser reposta para o original (se o valor for falso).

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

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

-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 no qual a origem de resultado correspondente esteja disponível.

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:False
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 à 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).

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

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:False
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 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 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 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.

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:False
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 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.

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

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.