New-SPEnterpriseSearchMetadataCrawledProperty

加入編目屬性。

Syntax

New-SPEnterpriseSearchMetadataCrawledProperty
   [-AssignmentCollection <SPAssignmentCollection>]
   -Category <CategoryPipeBind>
   [-Confirm]
   [-IsMappedToContents <Boolean>]
   -IsNameEnum <Boolean>
   -Name <String>
   -PropSet <Guid>
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-SiteCollection <Guid>]
   [-Tenant <Guid>]
   -VariantType <Int32>
   [-WhatIf]
   [<CommonParameters>]

Description

第一次設定搜尋功能時,會使用此 Cmdlet,並在第一次設定之後新增編目屬性。 SPEnterpriseSearchMetadataCrawledProperty 代表企業搜尋中繼資料屬性結構描述的編目屬性。 或者,編目屬性會在一般編目期間自動建立, (請參閱 SPEnterpriseSearchMetadataCategory) 。

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

範例

------------------範例------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$cat = Get-SPEnterpriseSearchMetadataCategory -SearchApplication $ssa -Identity People
$crawlprop = Get-SPEnterpriseSearchMetadataCrawledProperty -SearchApplication $ssa -Category $cat -Limit 1
New-SPEnterpriseSearchMetadataCrawledProperty -SearchApplication $ssa -Name "MyCrawlProp" -PropSet $crawlprop.PropSet -Category $crawlprop.CategoryName -IsNameEnum $false -VariantType $crawlprop.VariantType -IsMappedToContents $false

本範例會將新的編目屬性 MyCrawlProp 對應至預設搜尋服務應用程式的人員中繼資料類別。 對應會使用現有人員類別的條件約束。

參數

-AssignmentCollection

管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Category

指定編目屬性應該加入至哪個中繼資料類別目錄

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、中繼資料類別目錄的有效名稱,例如 MetadataCategory1 或有效 Category 物件的實例。

Type:CategoryPipeBind
Aliases:c
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

在執行命令之前,提示您確認操作。 如需詳細資訊,請輸入下列命令: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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-IsMappedToContents

指定編目屬性應該對應至 Managed 屬性。 設為 true 會將編目屬性對應到 Managed 屬性。

Type:Boolean
Aliases:im
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-IsNameEnum

指定編目屬性名稱是否為整數類型。 由 true 或 false 指定。

Type:Boolean
Aliases:ie
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

指定新編目屬性的身分識別。

此類型必須是有效的編目屬性名稱,例如 「urn:schemas-microsoft-com:sharepoint:portal:profile:UserName」

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

-PropSet

指定屬於現有類別的屬性集。

指定屬性集的有效 GUID,格式為 12345678-90ab-cdef-1234-567890bcdefgh。

Type:Guid
Aliases:p
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

指定包含已經過編目之屬性的搜尋應用程式。

此類型必須是有效的搜尋應用程式名稱 (例如 SearchApp1),或有效的 SearchServiceApplication 物件執行個體。

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteCollection

指定傳回的編目屬性在網站集合 (SPSite) 範圍內。

此類型必須是可以 12345678-90ab-cdef-1234-567890bcdefgh 格式指定屬性集的有效 GUID。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Tenant

指定傳回的編目屬性在承租人範圍內。

此類型必須是可以 12345678-90ab-cdef-1234-567890bcdefgh 格式指定屬性集的有效 GUID。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-VariantType

將編目屬性新增為指定的變體類型。 如需此屬性有效值的詳細資訊,請參閱 varIANT Type Constants (https://go.microsoft.com/fwlink/p/?LinkId=143322& clcid=0x409) (https://go.microsoft.com/fwlink/p/?LinkId=143322& clcid=0x409)

此類型必須是指定屬性集之 Variant 資料類型的整數。

注意事項

雖然在 SharePoint Server 2013 到 SharePoint Server 2019 中不會使用此值,但這是必要的參數。 執行 Cmdlet 時,您會看到過時的警告。 您可以忽略此訊息。

Type:Int32
Aliases:vt
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊,請輸入下列命令: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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019