Compartilhar via

Set-SPEnterpriseSearchResultItemType

Módulo:
SharePointServer module

Define as propriedades de um tipo de item de resultado.

Sintaxe

Default (Padrão) 

Set-SPEnterpriseSearchResultItemType
    [-Identity] <ResultItemTypePipeBind>
    -Owner <SearchObjectOwner>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DisplayProperties <String>]
    [-DisplayTemplateUrl <String>]
    [-Name <String>]
    [-OptimizeForFrequentUse <Boolean>]
    [-RulePriority <Int32>]
    [-Rules <PropertyRuleCollection>]
    [-SearchApplication <SearchServiceApplicationPipeBind>]
    [-SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>]
    [-SourceID <Guid>]
    [-WhatIf]
    [<CommonParameters>]

Description

O Set-SPEnterpriseSearchResultItemType cmdlet define as propriedades dos tipos de itens de resultados criados pelo utilizador. Não pode utilizar este cmdlet para definir ou alterar propriedades dos tipos de itens de resultado incorporados incluídos nos produtos SharePoint.

Os tipos de item de resultados permitem alterar a aparência dos resultados de pesquisa com base no tipo de resultado. Você começa definindo um conjunto de regras, que será avaliado em relação as propriedades dos resultados. Em seguida, defina o modelo de exibição para ser usado para processar esse tipo de resultado. Depois de ter criado o tipo de item de resultado, os resultados que correspondem às regras do tipo de item de resultado serão processadas usando o modelo de exibição especificado.

Casos de uso de exemplo:

  • Altere o aspeto dos resultados de uma extensão de nome de ficheiro específica, por exemplo, Word documentos.
  • Alterar a aparência de um determinado tipo de conteúdo nos resultados da pesquisa.
  • Alterar a aparência dos resultados de um determinado autor.
  • Adicionar uma ação de resultado para os resultados de uma fonte de resultados específica, como parte de um aplicativo de pesquisa personalizado.

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

$web = Get-SPWeb https://webUrl
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$ssa = Get-SPEnterpriseSearchServiceApplication
$resultType = Get-SPEnterpriseSearchResultItemType -Owner $tenantOwner -SearchApplication $ssa
$resultType.BuiltIn
$rule = Get-SPEnterpriseSearchPropertyRule -PropertyName "ContentTypeId" -Operator "StartsWith"
$rule.AddValue('0x010063C2F478ACC511DFB869B5BFDFD720851252')
$ruleCollection = Get-SPEnterpriseSearchPropertyRuleCollection
$ruleCollection.Add($rule)
$displayProperties = "WorkId,Rank,Title,Size,Path,Description,SiteName,HitHighlightedSummary,HitHighlightedProperties,ViewsLifeTime"
$displaytemplateUrl = "~sitecollection/_catalogs/masterpage/Display Templates/Search/Item_MyCustomDisplayTemplate.js"
Set-SPEnterpriseSearchResultItemType
-Identity $resultType `
-SearchApplication $ssa `
-Name "CustomResultType" `
-Rules $ruleCollection `
-RulePriority 1
-DisplayProperties $displayProperties `
-DisplayTemplateUrl $displaytemplateUrl `
-Owner $tenantOwner

Este exemplo define primeiro as variáveis para o URL do site, o proprietário da pesquisa e a aplicação de pesquisa. Ele recupera o tipo de item de resultado e verifica se o tipo de item de resultado é interno. Se $resultType.BuiltIn devolver falso, o tipo de item de resultado não está incorporado e pode definir as respetivas propriedades com o Set-SPEnterpriseSearchResultItemType.

Em seguida, o exemplo cria a regra com a qual os tipos de item de resultado devem ser correspondidos e adiciona-os a uma coleção de regras de propriedade.

Em seguida, o exemplo define as propriedades do tipo de item de resultado que devem ser exibidas e o modelo de exibição a ser usado.

Por fim, o exemplo utiliza o Set-SPEnterpriseSearchResultItemType cmdlet para modificar o tipo de item de resultado.

Parâmetros

-AssignmentCollection

Aplicável: 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

-Confirm

Aplicável: 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

-DisplayProperties

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

Especifica as propriedades do resultado a serem exibidas.

Propriedades do parâmetro

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

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

-DisplayTemplateUrl

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

Especifica a URL do modelo de exposição que deve ser usada para processar os resultados.

Propriedades do parâmetro

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

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 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o tipo de item de resultado a ser atualizado. O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Name

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

Especifica o nome do tipo de item de resultado.

Propriedades do parâmetro

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

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

-OptimizeForFrequentUse

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

{{ Fill OptimizeForFrequentUse Description }}

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:optar por

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 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o proprietário do objeto de pesquisa que define o escopo no qual o tipo de item de resultado é criado.

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

-RulePriority

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

Especifica a prioridade na qual a coleção de regras é comparada a outras regras.

Propriedades do parâmetro

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

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

-Rules

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

Especifica o conjunto de regras contra o qual são avaliadas as propriedades de resultado.

Propriedades do parâmetro

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

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 2013, SharePoint Server 2016 SharePoint Server 2019

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

-SearchApplicationProxy

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

Especifica o proxy do aplicativo de pesquisa que contém o tipo de item de resultado. 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, SearchAppProxy1) ou uma instância de um objeto SearchServiceApplicationProxy válido.

Propriedades do parâmetro

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

-SourceID

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

Identifica a fonte de resultados de pesquisa à qual se aplica o tipo de item.

Propriedades do parâmetro

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

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