Set-SPEnterpriseSearchResultItemType
Define as propriedades de um tipo de item de resultado.
Syntax
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 item de resultado criados pelo usuário.
Você não pode usar esse cmdlet para definir ou alterar as propriedades dos tipos de item de resultado internos incluídos nos produtos do 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 a aparência dos resultados de uma extensão de nome de arquivo específica, por exemplo, documentos do Word.
- 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 $tenantOwnerEste exemplo primeiro define variáveis para a URL do site, o proprietário da pesquisa e o aplicativo de pesquisa.
Ele recupera o tipo de item de resultado e verifica se o tipo de item de resultado é interno.
Se $resultType.BuiltIn retornar false, o tipo de item de resultado não será interno e você poderá definir suas propriedades usando o Set-SPEnterpriseSearchResultItemType.
Em seguida, o exemplo cria a regra em que 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 usa o Set-SPEnterpriseSearchResultItemType cmdlet para modificar o tipo de item de resultado.
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 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DisplayProperties
Especifica as propriedades do resultado a serem exibidas.
| Type: | String |
| Aliases: | dp |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DisplayTemplateUrl
Especifica a URL do modelo de exposição que deve ser usada para processar os resultados.
| Type: | String |
| Aliases: | url |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
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.
| Type: | ResultItemTypePipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Name
Especifica o nome do tipo de item de resultado.
| Type: | String |
| Aliases: | n |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-OptimizeForFrequentUse
{{ Otimizar de preenchimentoForFrequentUse Description }}
| Type: | Boolean |
| Aliases: | opt |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Owner
Especifica o proprietário do objeto de pesquisa que define o escopo no qual o tipo de item de resultado é criado.
| Type: | SearchObjectOwner |
| Aliases: | o |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-RulePriority
Especifica a prioridade na qual a coleção de regras é comparada a outras regras.
| Type: | Int32 |
| Aliases: | priority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Rules
Especifica o conjunto de regras contra o qual são avaliadas as propriedades de resultado.
| Type: | PropertyRuleCollection |
| Aliases: | rule |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SearchApplication
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
| Type: | SearchServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SearchApplicationProxy
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.
| Type: | SearchServiceApplicationProxyPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SourceID
Identifica a fonte de resultados de pesquisa à qual se aplica o tipo de item.
| Type: | Guid |
| Aliases: | sid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de