New-SPEnterpriseSearchResultItemType

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

Crea un nuovo tipo di elemento dei risultati.

Sintassi

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

Descrizione

Usare il New-SPEnterpriseSearchResultItemType cmdlet per creare un nuovo tipo di elemento di risultato.

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

$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

In questo esempio viene innanzitutto definita la regola da applicare ai risultati della ricerca per ottenere risultati di destinazione con una proprietà specifica e la regola viene aggiunta all'insieme di regole.

Nell'esempio vengono quindi definiti le proprietà del risultato che verrà visualizzato e l'URL del modello di visualizzazione che definisce l'aspetto dei risultati visualizzati.

Infine, l'esempio definisce il tipo di elemento della regola in base al nome, alla raccolta di regole, alle proprietà di visualizzazione, al modello di visualizzazione e al proprietario del tenant.

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:5
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. Specificare un URL assoluto.

Type:String
Aliases:url
Position:7
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ExistingResultItemType

Specifica un tipo di elemento dei risultati esistente a cui possono essere aggiunte nuove regole o proprietà visualizzate.

Type:ResultItemTypePipeBind
Aliases:copy
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

-ExistingResultItemTypeOwner

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

Type:SearchObjectOwner
Aliases:eo
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

-Name

Specifica il nome del tipo di elemento dei risultati.

Type:String
Aliases:n
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-OptimizeForFrequentUse

Abilitare questo flag se si desidera che vengano sempre richieste le proprietà di questo tipo di elemento dei risultati, indipendentemente dall'eventualità o meno che venga attivato il tipo di risultato. In questo modo verranno migliorate le prestazioni purché sia abilitato solo nei tipi di elementi dei risultati utilizzati più frequentemente.

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 viene 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:4
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:3
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

Specifica l'applicazione di ricerca che contiene il tipo di elemento dei risultati. 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:True
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. Lasciare questo parametro vuoto per applicare il tipo di elemento dei risultati a tutte le origini dei risultati.

Type:Guid
Aliases:sid
Position:6
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