Compartilhar via


Remove-SPEnterpriseSearchResultItemType

Remove um tipo de item de resultado para um proprietário de objeto de pesquisa.

Syntax

Remove-SPEnterpriseSearchResultItemType
      [-Identity] <ResultItemTypePipeBind>
      -Owner <SearchObjectOwner>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-SearchApplication <SearchServiceApplicationPipeBind>]
      [-SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>]
      [-WhatIf]
      [<CommonParameters>]

Description

O Remove-SPEnterpriseSearchResultItemType cmdlet remove um tipo de item de resultado criado pelo usuário, dada uma identidade de tipo de resultado e um proprietário de pesquisa. Você não pode usar esse cmdlet para remover os 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 exibidas 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 "UrlOfTheSite"
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$searchapp = Get-SPEnterpriseSearchServiceApplication
$resultType = Get-SPEnterpriseSearchResultItemType -Owner $tenantOwner -SearchApplication $searchapp
Remove-SPEnterpriseSearchResultItemType -Identity $resultType -Owner $tenantOwner -SearchApplication $searchapp

Este 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 item de resultado de pesquisa não será interno e você poderá modificá-lo. Em seguida, o exemplo remove o tipo de item de resultado referenciado por $resultType para o proprietário referenciado por $tenantOwner

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. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

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

-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

-Owner

Especifica o proprietário do objeto de pesquisa que define o escopo no qual o tipo de item de resultado foi 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

-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

-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