共用方式為


Remove-SPEnterpriseSearchResultItemType

移除搜尋物件擁有者的結果項目類型。

語法

Default (預設值)

Remove-SPEnterpriseSearchResultItemType
    [-Identity] <ResultItemTypePipeBind>
    -Owner <SearchObjectOwner>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-SearchApplication <SearchServiceApplicationPipeBind>]
    [-SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>]
    [-WhatIf]
    [<CommonParameters>]

Description

Cmdlet Remove-SPEnterpriseSearchResultItemType 會移除使用者建立的結果項目類型,並指定結果類型身分識別和搜尋擁有者。 您無法使用此 Cmdlet 移除 SharePoint 產品隨附的內建結果項目類型。

結果項目類型可讓您根據結果類型變更搜尋結果的外觀。 首先您要定義規則集合 (將會比對結果屬性來評估此規則集合)。 然後您要定義用來呈現結果類型的顯示範本。 建立結果項目類型之後,符合結果項目類型規則的結果就會使用指定的顯示範本來顯示。

使用範例:

  • 變更特定副檔名的結果外觀,例如 Word 文件。

  • 變更搜尋結果中,特定內容類型的外觀。

  • 變更特定作者的結果外觀。

  • 將結果動作新增至特定結果來源中的結果,以做為自訂搜尋應用程式的一部分。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱位於 SharePoint Server Cmdlets 的線上文件。

範例

$web = Get-SPWeb "UrlOfTheSite"
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$searchapp = Get-SPEnterpriseSearchServiceApplication
$resultType = Get-SPEnterpriseSearchResultItemType -Owner $tenantOwner -SearchApplication $searchapp
Remove-SPEnterpriseSearchResultItemType -Identity $resultType -Owner $tenantOwner -SearchApplication $searchapp

此範例會先定義網站 URL、搜尋擁有者和搜尋應用程式的變數。 然後它會擷取結果項目類型,並檢查結果項目類型是否為內建結果項目類型。 如果 $resultType.BuiltIn 傳回 false,表示不是內建結果項目類型,您可以加以修改。 接著,此範例會針對 $tenantOwner 參照的擁有者,移除 $resultType 參照的結果項目類型。

參數

-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

-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

-Owner

適用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定定義結果項目類型建立範圍的搜尋物件擁有者。

參數屬性

類型:SearchObjectOwner
預設值:None
支援萬用字元:False
不要顯示:False
別名:o

參數集

(All)
Position:Named
必要:True
來自管線的值: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

-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