Set-SPEnterpriseSearchResultItemType
Définit les propriétés d'un type d'élément de résultat.
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
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 des documents Word.
- 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 $tenantOwnerCet 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
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.
| 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
Vous demande une confirmation avant d’exécuter la commande.
Pour plus d’informations, entrez la commande suivante : 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
Spécifie quelles propriétés de résultat afficher.
| 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
Spécifie l’URL du modèle d’affichage qui doit être utilisé pour restituer les résultats.
| 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
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.
| 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
Spécifie le nom du type d’élément de résultat.
| 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
{{ Fill OptimizeForFrequentUse 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
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éé.
| 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
Spécifie la priorité de la collection de règles par rapport aux autres règles.
| 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
Spécifie la collection de règles par rapport auxquelles les propriétés de résultat doivent être évaluées.
| 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
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.
| 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
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.
| 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
Identifie l’origine des résultats de la recherche à laquelle s’applique le type d’élément de résultat.
| 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
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
| 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 |
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour