Set-SPEnterpriseSearchResultItemType

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Imposta le proprietà di un tipo di elemento dei risultati.

Sintassi

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>]

Descrizione

Il Set-SPEnterpriseSearchResultItemType cmdlet imposta le proprietà dei tipi di elemento risultato creati dall'utente. Non è possibile usare questo cmdlet per impostare o modificare le proprietà dei tipi di elemento dei risultati predefiniti inclusi nei prodotti SharePoint.

I tipi di elementi dei risultati consentono di modificare l'aspetto dei risultati della ricerca in base al tipo di risultato. A tale scopo, è innanzitutto necessario definire un insieme di regole che verranno valutate a fronte delle proprietà dei risultati. È quindi necessario definire il modello di visualizzazione da utilizzare per il rendering del tipo di risultato. Dopo la creazione del tipo di elemento dei risultati, verrà eseguito il rendering dei risultati che soddisfano le regole del tipo di elemento utilizzando il modello di visualizzazione specificato.

Casi di utilizzo di esempio:

  • Modificare l'aspetto dei risultati per una particolare estensione di file, ad esempio documenti di Word.
  • Modificare l'aspetto di un tipo di contenuto specifico nei risultati della ricerca.
  • Modificare l'aspetto dei risultati di un autore specifico.
  • Aggiungere un'azione ai risultati provenienti da un'origine di risultati specifica nell'ambito di un'applicazione di ricerca personalizzata.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

--------------------ESEMPIO---------------------

$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

Questo esempio definisce innanzitutto le variabili per l'URL del sito, il proprietario della ricerca e l'applicazione di ricerca. Viene recuperato il tipo di elemento dei risultati e viene controllato se si tratta di un tipo di elemento dei risultati predefinito. Se $resultType.BuiltIn restituisce false, il tipo di elemento risultato non è predefinito ed è possibile impostarne le proprietà tramite Set-SPEnterpriseSearchResultItemType.

Successivamente, l'esempio crea la regola su cui devono essere confrontati i tipi di elemento risultato e la aggiunge a una raccolta di regole di proprietà.

Vengono definiti quindi le proprietà del tipo di elemento dei risultati che verranno visualizzate e il modello di visualizzazione da utilizzare.

Infine, l'esempio usa il Set-SPEnterpriseSearchResultItemType cmdlet per modificare il tipo di elemento risultato.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Specifica quali proprietà dei risultati visualizzare.

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

Specifica l'URL del modello di visualizzazione che verrà utilizzato per il rendering dei risultati.

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

Specifica il tipo di elemento dei risultati da aggiornare. Il tipo deve essere un GUID valido nel 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

Specifica il nome del tipo di elemento dei risultati.

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

Specifica il proprietario dell'oggetto di ricerca che definisce l'ambito a livello del quale è stato creato il tipo di elemento dei risultati.

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

Specifica la priorità della raccolta di regole rispetto ad altre regole.

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

Specifica la raccolta di regole in base alla quale valutare le proprietà dei risultati.

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

Specifica il nome dell'applicazione di ricerca. Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome di applicazione di ricerca valido, ad esempio AppRicerca1, oppure un'istanza di un oggetto SearchServiceApplication valido.

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

Specifica il proxy dell'applicazione di ricerca contenente il tipo di elemento dei risultati. Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome di proxy di applicazione di ricerca valido, ad esempio ProxyAppRicerca1, oppure un'istanza di un oggetto SearchServiceApplicationProxy valido.

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 l'origine dei risultati della ricerca a cui si applica il tipo di elemento dei risultati.

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

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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