Set-SPEnterpriseSearchResultSource
設定結果來源的屬性。
Syntax
Set-SPEnterpriseSearchResultSource
[-AssignmentCollection <SPAssignmentCollection>]
[-AuthenticationType <FederationAuthType>]
[-AutoDiscover <Boolean>]
[-Confirm]
[-Description <String>]
-Identity <ResultSourcePipeBind>
[-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 支援與透過管理中心的 [管理結果來源] 頁面所支援的相同更新作業。 除了使用 MakeDefault 參數變更預設結果來源之外,任何更新作業的 BuiltIn 屬性設定為 true) ,則結果來源不能是內建來源 (。 如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
--------------------範例 1---------------------
$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"
此範例會更新結果來源的名稱,並將結果來源的身分識別指定為結果來源實例。 此更新作業不需要 SearchApplication 和 Owner。
--------------------範例 2---------------------
$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"
此範例會更新結果來源的描述,並依名稱指定結果來源的身分識別。
參數
-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) 表示應該使用自動探索。
如果未指定參數,則值會保持不變。
僅適用于使用 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 |
-Identity
指定要更新的結果來源。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID 字串;結果來源的有效名稱 (例如「自訂 SharePoint 結果來源」) ;或有效 Source 物件的實例。
Type: | ResultSourcePipeBind |
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 |
-MakeDefault
指定是否應針對 Owner 參數所指定的範圍,將結果來源設定為預設結果來源。
如果未指定參數,則預設結果來源將不會變更。
將值設定為 true ($true) 表示應該將結果來源設定為預設值。
將值設定為 false ($false) 表示不應該將結果來源設定為預設值,在此情況下,如果要更新的結果來源目前是預設值,則會再次將原始的預設結果來源 (「本機 SharePoint 結果」) 設定為預設值。
提示:使用 Makedefault 時,請使用實例,而非名稱或 GUID 字串識別碼作為 Identity,以明確指定 Owner 僅用於指定當值為 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: | False |
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: | False |
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: | False |
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: | False |
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 |