Set-SPEnterpriseSearchResultItemType
設定結果項目類型的屬性。
語法
Default (預設值)
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
Cmdlet Set-SPEnterpriseSearchResultItemType 會設定使用者建立結果項目類型的屬性。
您無法使用此 Cmdlet 來設定或變更 SharePoint 產品隨附之內建結果項目類型的屬性。
結果項目類型可讓您根據結果類型變更搜尋結果的外觀。 首先您要定義規則集合 (將會比對結果屬性來評估此規則集合)。 然後您要定義用來呈現結果類型的顯示範本。 建立結果項目類型之後,符合結果項目類型規則的結果就會使用指定的顯示範本來呈現。
使用範例:
- 變更特定副檔名的結果外觀,例如 Word 文件。
- 變更搜尋結果中,特定內容類型的外觀。
- 變更特定作者的結果外觀。
- 將結果動作新增至特定結果來源中的結果,以做為自訂搜尋應用程式的一部分。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱位於 SharePoint Server Cmdlets 的線上文件。
範例
例
$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
此範例會先定義網站 URL、搜尋擁有者和搜尋應用程式的變數。
它會擷取結果項目類型,並檢查結果項目類型是否為內建結果項目類型。
如果 $resultType.BuiltIn 傳回 false,則結果項目類型不是內建的,而且您可以使用 Set-SPEnterpriseSearchResultItemType來設定其屬性。
接著,此範例會建立結果項目類型應符合的規則,並將其新增至屬性規則集合。
然後,此範例會定義應顯示的結果項目類型屬性並顯示要使用的範本。
最後,此範例會使用 Set-SPEnterpriseSearchResultItemType Cmdlet 以修改結果項目類型。
參數
-AssignmentCollection
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。
使用 Global 參數時,所有物件會包含在全域儲存區內。
如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
在執行命令之前,提示您確認操作。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayProperties
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要顯示哪些結果屬性。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | dp |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayTemplateUrl
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定應用於呈現結果之顯示範本的 URL。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | URL |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要更新的結果項目類型。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID。
參數屬性
| 類型: | ResultItemTypePipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定結果項目類型的名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | n |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OptimizeForFrequentUse
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
{{ Fill OptimizeForFrequentUse Description }}
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 選擇 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Owner
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定可在已建立的結果項目類型定義範圍的搜尋物件擁有者。
參數屬性
| 類型: | SearchObjectOwner |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | o |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RulePriority
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定規則集合與其他規則相較的優先順序。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 優先權 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Rules
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要用來評估結果屬性的規則集合。
參數屬性
| 類型: | PropertyRuleCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 統治 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SearchApplication
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定搜尋應用程式的名稱。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的搜尋應用程式名稱 (例如 SearchApp1);或有效之 SearchServiceApplication 物件的執行個體。
參數屬性
| 類型: | SearchServiceApplicationPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SearchApplicationProxy
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定包含結果項目類型的搜尋應用程式 Proxy。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的搜尋應用程式 Proxy 名稱 (例如 SearchAppProxy1);或有效之 SearchServiceApplicationProxy 物件的執行個體。
參數屬性
| 類型: | SearchServiceApplicationProxyPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SourceID
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定可套用結果項目類型的搜尋結果來源。
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | sid |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。