Compartilhar via

New-SPEnterpriseSearchResultItemType

Módulo:
SharePointServer module

Cria um novo tipo de item de resultado.

Sintaxe

New 

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

Copy 

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

Description

Utilize o New-SPEnterpriseSearchResultItemType cmdlet para criar um novo tipo de item de resultado.

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

$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"
$web = Get-SPWeb https://webUrl
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$proxy = Get-SPEnterpriseSearchServiceApplicationProxy
New-SPEnterpriseSearchResultItemType -SearchApplicationProxy $proxy `
>> -Name "CustomResultType" `
>> -Rules $ruleCollection `
>> -RulePriority 1 `
>> -DisplayProperties $displayProperties `
>> -DisplayTemplateUrl $displaytemplateUrl `
>> -Owner $tenantOwner

Este exemplo define primeiro a regra a aplicar aos resultados da pesquisa para direcionar os resultados com uma propriedade específica e adiciona a regra à coleção de regras.

Depois disso, o exemplo define as propriedades do resultado que deve ser exibido e a URL para o modelo de exibição que rege a aparência dos resultados processados.

Por fim, o exemplo define o tipo de item de regra pelo respetivo nome, a coleção de regras, as propriedades de apresentação, o modelo de apresentação e o proprietário do inquilino.

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:5
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. Especifique uma URL absoluta.

Propriedades do parâmetro

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

Conjuntos de parâmetros

New
Cargo:7
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Copy
Cargo:7
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExistingResultItemType

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

Especifica um tipo de item de resultado existente ao qual podem ser adicionadas novas regras ou propriedades exibidas.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Copy
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExistingResultItemTypeOwner

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 existente foi criado.

Propriedades do parâmetro

Tipo:SearchObjectOwner
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:eo

Conjuntos de parâmetros

Copy
Cargo:Named
Obrigatório:True
Valor do pipeline:False
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

New
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Copy
Cargo:2
Obrigatório:True
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

Habilite este sinalizador se você deseja sempre que as propriedades desse tipo de item de resultado sejam solicitadas, independentemente se o tipo de resultado é acionado. Isso melhora o desempenho, enquanto ele só é habilitado aos tipos de item de resultado mais frequentemente usados.

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 foi 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:4
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

New
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Copy
Cargo:3
Obrigatório:True
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 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, 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

-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. Deixar este parâmetro em branco para aplicar a todas as fontes de resultado.

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