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.