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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-SearchApplication
指定包含已經過編目之屬性的搜尋應用程式。
此類型必須是有效的搜尋應用程式名稱 (例如 SearchApp1)，或有效的 SearchServiceApplication 物件執行個體。
| Type: | SearchServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |