New-SPEnterpriseSearchResultSource
建立新的結果來源。
Syntax
New-SPEnterpriseSearchResultSource
[-AssignmentCollection <SPAssignmentCollection>]
[-AuthenticationType <FederationAuthType>]
[-AutoDiscover <Boolean>]
[-Confirm]
[-Description <String>]
[-MakeDefault <Boolean>]
-Name <String>
-Owner <SearchObjectOwner>
[-Password <String>]
-ProviderId <Guid>
[-QueryTemplate <String>]
[-RemoteUrl <String>]
-SearchApplication <SearchServiceApplicationPipeBind>
[-SsoId <String>]
[-UserName <String>]
[-WhatIf]
[<CommonParameters>] Description
此 Cmdlet 會建立結果來源。 使用結果來源將搜尋結果的範圍和查詢同盟至外部來源，例如網際網路搜尋引擎。 定義結果來源之後，請設定搜尋網頁元件和查詢規則動作來使用它。 結果來源會取代搜尋範圍，這些範圍現在已被取代。 此 Cmdlet 支援與透過管理中心的 [管理結果來源] 頁面所支援的相同建立作業，但「表單驗證」和「Cookie 驗證」作業除外。 如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
------------------範例------------------
$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"此範例會建立名為「自訂 SharePoint 結果來源」的新搜尋服務應用層級結果來源。
參數
-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 |
-AuthenticationType
指定新結果來源的驗證類型。
每個搜尋提供者類型都支援一組特定的驗證類型，如果未指定參數，則驗證類型會根據搜尋提供者類型來預設。
此 Cmdlet 支援下列一組驗證機制和對應的類型：預設 SharePoint 驗證 (FederationAuthType.LocalNTAuth) 、 基本驗證 (FederationAuthType.SingleAccountBasicAuth - 指定 UserName 和 Password) 、Default Remote SharePoint Authentication (FederationAuthType.PerUserBasicAuth) 、Single Sign On (FederationAuthType.SSO - 需要指定 SsoId) 、Anonymous (FederationAuthType.Anonymous) 、Digest 驗證 (FederationAuthType.SingleAccountDigest - 指定 UserName 和 Password) 、NTLM 應用程式集區身分識別 (FederationAuthType.ApplicationPoolIdentity) 、NTLM 使用者名稱和密碼 (FederationAuthType.SingleAccountNTLM - 指定 UserName 和 Password) 。
使用本機 SharePoint 搜尋/本機 SharePoint 人員搜尋提供者時，則支援 FederationAuthType.LocalNTAuth (預設) 和 FederationAuthType.SingleAccountBasicAuth。
使用遠端 SharePoint 搜尋/遠端 SharePoint 人員搜尋提供者時，則支援 FederationAuthType.PerUserBasicAuth (預設) 和 FederationAuthType.SSO。
使用 OpenSearch 1.0/1.1 搜尋提供者時，支援下列驗證類型：FederationAuthType.Anonymous (預設) 、FederationAuthType.SingleAccountBasicAuth、FederationAuthType.SingleAccountDigest、FederationAuthType.SingleAccountNTLM 和 FederationAuthType.ApplicationPoolIdentity。
所有驗證類型都會列在 FederationAuthType 列舉中。
| Type: | FederationAuthType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AutoDiscover
指定是否要針對新的結果來源使用 Exchange Server 端點的自動探索。
將值設定為 true ($true) 表示應該使用自動探索。 如果未指定或設定為 false ($false) ，則不會使用自動探索。
僅適用于使用 Exchange 搜尋提供者時。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Description
指定新結果來源的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-MakeDefault
指定是否應針對 Owner 參數所指定的範圍，將新的結果來源設定為預設值。
將值設定為 true ($true) 表示應該將結果來源設定為預設值。 如果未指定或設定為 false，新的結果來源將不會設定為預設值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
指定新結果來源的名稱。
每個系統管理層級的名稱都必須是唯一的。
例如，網站中的兩個結果來源無法共用名稱稱，但一個在網站中，一個由網站集合提供。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Owner
指定搜尋物件擁有者，定義建立對應結果來源的範圍。
| Type: | SearchObjectOwner |
| Aliases: | o |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Password
指定用來連線到新結果來源的使用者認證密碼。
當驗證類型 (AuthenticationType) 設定為 (FederationAuthType.SingleAccountBasicAuth、FederationAuthType.SingleAccountDigest 或 FederationAuthType.SingleAccountNTLM) 取用使用者認證的類型時使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ProviderId
指定要由新結果來源使用的搜尋提供者。
指定為 Guid 或 GUID 字串，必須是下列其中一項：FA947043-6046-4F97-9714-40D4C113963D (本機 SharePoint 搜尋) 、 E4BCC058-F133-4425-8FFC-1D70596FFD33 (本機 SharePoint 人員搜尋) 、 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (遠端 SharePoint 搜尋) ，E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (遠端 SharePoint 人員 搜尋) 、 3A17E140-1574-4093-BAD6-E19CDF1C0122 (Exchange 搜尋) ，3A17E140-1574-4093-BAD6-E19CDF1C0121 (OpenSearch 1.0/1.1) 。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-QueryTemplate
指定新結果來源的查詢轉換範本。
傳入查詢會根據範本變更，改為使用這個新的查詢文字。 使用查詢變數 「{searchTerms}」，在新的文字中包含傳入查詢。 使用此值來設定結果的範圍。
例如，若只要傳回 OneNote 專案，請將新文字設定為 「{searchTerms} fileextension=one」。 然後，傳入的查詢 「sharepoint」 會變成 「sharepoint fileextension=one」。 預設值為 {searchTerms}。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-RemoteUrl
指定新結果來源的連線 URL 範本。
使用取用它的搜尋提供者時必須設定：遠端 SharePoint 搜尋、遠端 SharePoint 人員搜尋、OpenSearch 1.0/1.1 和 Exchange (如果自動探索未開啟) 。
使用其他搜尋提供者時，會忽略 參數。
針對 [遠端 SharePoint 搜尋/遠端 SharePoint 人員搜尋]，指定遠端 SharePoint 伺服器陣列之根網站集合的位址。
針對 OpenSearch 1.0/1.1，指定 OpenSearch 來源的 URL。
使用查詢變數 「{searchTerms}」 在 URL 中包含查詢，該變數會自動取代為查詢。 針對 Exchange，指定要從中擷取結果的 Exchange EWS URL。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SearchApplication
指定搜尋應用程式。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID；有效的搜尋應用程式名稱 (例如 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 |
-SsoId
指定用來連線到新結果來源的反向 Proxy 憑證 Secure Store Id。
如果 AuthenticationType (驗證類型) 設定為 FederationAuthType.SSO (單一登入) ，則必須指定。
如果您要透過反向 Proxy 連線到內部網路，請輸入單一登入專案的 SSO 識別碼，以儲存用來對反向 Proxy 進行驗證的憑證。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UserName
指定用來連接到新結果來源之使用者認證的使用者名稱。
當驗證類型 (AuthenticationType) 設定為 (FederationAuthType.SingleAccountBasicAuth、FederationAuthType.SingleAccountDigest 或 FederationAuthType.SingleAccountNTLM) 取用使用者認證的類型時使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |