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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 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

-Description

指定新結果來源的描述。

Type:String
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

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

指定新結果來源的名稱。

每個系統管理層級的名稱都必須是唯一的。

例如,網站中的兩個結果來源無法共用名稱稱,但一個在網站中,一個由網站集合提供。

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

-Owner

指定搜尋物件擁有者,定義建立對應結果來源的範圍。

Type:SearchObjectOwner
Aliases:o
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

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 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