Partager via

Set-SPEnterpriseSearchResultItemType

Module:
SharePointServer module

Définit les propriétés d'un type d'élément de résultat.

Syntaxe

Default (Par défaut) 

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

L’applet Set-SPEnterpriseSearchResultItemType de commande définit les propriétés des types d’éléments de résultats créés par l’utilisateur. Vous ne pouvez pas utiliser cette applet de commande pour définir ou modifier les propriétés des types d’éléments de résultat intégrés inclus dans les produits SharePoint.

Les types d’élément de résultat vous permettent de modifier l’apparence des résultats de recherche en fonction du type de résultat. Vous commencez par définir une collection de règles, qui seront évaluées par rapport aux propriétés des résultats. Ensuite, vous définissez le modèle d’affichage à utiliser pour restituer ce type de résultat. Une fois que vous avez créé le type d’élément de résultat, les résultats correspondant aux règles du type d’élément de résultat seront affichés à l’aide du modèle d’affichage spécifié.

Exemples de cas d’utilisation :

  • Modifiez l’apparence des résultats pour une extension de nom de fichier particulière, par exemple Word documents.
  • Modifier l’apparence d’un type de contenu particulier dans les résultats de recherche.
  • Modifier l’apparence des résultats provenant d’un auteur spécifique.
  • Ajouter une action sur les résultats aux résultats provenant d’une origine de résultats spécifique dans le cadre d’une application de recherche personnalisée.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

EXEMPLE

$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

Cet exemple définit d’abord des variables pour l’URL du site, le propriétaire de recherche et l’application de recherche. Il extrait le type d’élément de résultat et vérifie si le type d’élément de résultat est un type d’élément de résultat intégré. Si $resultType.BuiltIn retourne false, le type d’élément de résultat n’est pas intégré et vous pouvez définir ses propriétés à l’aide de Set-SPEnterpriseSearchResultItemType.

Ensuite, l’exemple crée la règle à laquelle les types d’éléments de résultat doivent être mis en correspondance et l’ajoute à une collection de règles de propriété.

Ensuite, l’exemple définit les propriétés du type d’élément de résultat qui doivent être affichées, ainsi que le modèle d’affichage à utiliser.

Enfin, l’exemple utilise l’applet de Set-SPEnterpriseSearchResultItemType commande pour modifier le type d’élément de résultat.

Paramètres

-AssignmentCollection

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisplayProperties

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie quelles propriétés de résultat afficher.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Dp

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisplayTemplateUrl

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie l’URL du modèle d’affichage qui doit être utilisé pour restituer les résultats.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:url

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie le type d’élément de résultat à mettre à jour. Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh.

Propriétés du paramètre

Type:ResultItemTypePipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie le nom du type d’élément de résultat.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:n

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OptimizeForFrequentUse

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

{{ Fill OptimizeForFrequentUse Description }}

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:opter

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Owner

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie le propriétaire de l’objet de recherche qui définit l’étendue à laquelle le type d’élément de résultat a été créé.

Propriétés du paramètre

Type:SearchObjectOwner
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:o

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RulePriority

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie la priorité de la collection de règles par rapport aux autres règles.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:priorité

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Rules

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie la collection de règles par rapport auxquelles les propriétés de résultat doivent être évaluées.

Propriétés du paramètre

Type:PropertyRuleCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:règle

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SearchApplication

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie le nom de l’application de recherche. Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, à un nom d’application de recherche valide (par exemple, SearchApp1) ou à une instance d’un objet SearchServiceApplication valide.

Propriétés du paramètre

Type:SearchServiceApplicationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SearchApplicationProxy

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie le proxy de l’application de recherche qui contient le type d’élément de résultat. Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, à un nom de proxy d’application de recherche valide (par exemple, SearchAppProxy1) ou à une instance d’un objet SearchServiceApplicationProxy valide.

Propriétés du paramètre

Type:SearchServiceApplicationProxyPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SourceID

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Identifie l’origine des résultats de la recherche à laquelle s’applique le type d’élément de résultat.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Sid

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.