Set-SPEnterpriseSearchResultSource
設定結果來源的屬性。
語法
Default (預設值)
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 支援與管理中心中 [管理結果來源] 頁面所支援的相同更新作業。 結果來源不能是內建來源， (內建來源的 BuiltIn 屬性設定為 True，) 除了使用 MakeDefault 參數變更預設結果來源以外的任何更新作業。 如需適用於 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
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AuthenticationType
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定結果來源的驗證類型。 如果未指定參數，則值不會變更。
每個搜尋提供者類型都支援一組特定的驗證類型，如果未指定參數，則驗證類型會根據搜尋提供者類型來預設。
此 Cmdlet 支援下列一組驗證機制和對應類型：預設 SharePoint 驗證 (FederationAuthType.LocalNTAuth) 、基本驗證 (FederationAuthType.SingleAccountBasicAuth - 指定 UserName 和密碼) 、預設遠端 SharePoint 驗證 (FederationAuthType.PerUserBasicAuth) 單一登入 (FederationAuthType.SSO - 需要指定 SsoId) 、Anonymous (FederationAuthType.Anonymous) 、摘要式驗證 (FederationAuthType.SingleAccountDigest - 指定使用者名稱和密碼) 、NTLM 應用程式集區身分識別 (FederationAuthType.ApplicationPoolIdentity) 、NTLM 使用者名稱和密碼 (FederationAuthType.SingleAccountNTLM - 指定使用者名稱和密碼) 。
使用本機 SharePoint 搜尋/本機 SharePoint People 搜尋提供者時，支援 FederationAuthType.LocalNTAuth (預設) 和 FederationAuthType.SingleAccountBasicAuth。
使用遠端 SharePoint 搜尋/遠端 SharePoint People 搜尋提供者時，支援 FederationAuthType.PerUserBasicAuth (預設) 和 FederationAuthType.SSO。
使用 OpenSearch 1.0/1.1 搜尋提供者時，支援下列驗證類型：FederationAuthType.Anonymous (預設) 、FederationAuthType.SingleAccountBasicAuth、FederationAuthType.SingleAccountDigest、FederationAuthType.SingleAccountNTLM 和 FederationAuthType.ApplicationPoolIdentity。
所有驗證類型都列在列舉 FederationAuthType 中。
參數屬性
| 類型: | FederationAuthType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AutoDiscover
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定是否要針對結果來源使用 Exchange Server 端點的自動探索。
將值設定為 true ($true) 表示應該使用自動探索。
如果未指定參數，則值不會變更。
僅適用於使用 Exchange 搜尋提供者。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
在執行命令之前，提示您確認操作。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Description
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定結果來源的描述。
如果未指定參數，則值不會變更。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定要更新的結果來源。
類型必須是有效的 GUID 字串，格式為 12345678-90ab-cdef-1234-567890bcdefgh;結果來源的有效名稱 (例如「自訂 SharePoint 結果來源」) ;或有效來源物件的執行個體。
參數屬性
| 類型: | ResultSourcePipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MakeDefault
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
針對 Owner 參數指定的範圍，指定是否應將結果來源設定為預設結果來源。
如果未指定參數，則預設的結果來源將不會變更。
將值設定為 true ($true) 表示應將結果來源設定為預設值。
將值設定為 false ($false) 表示不應將結果來源設定為預設值，在此情況下，如果要更新的結果來源目前為預設值，則會再次將原始預設結果來源 (「本機 SharePoint 結果」) 設為預設值。
提示：使用 Makedefault 時，使用執行個體而非名稱或 GUID 字串 ID 做為身分識別，以明確指定 [擁有者] 僅用於指定層級，其中結果來源應設為預設值 (如果值為 true) ，或預設值應重設為原始 (如果值為 false) 。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定結果來源的名稱。
如果未指定參數，則值不會變更。
每個管理層級的名稱都必須是唯一的。
例如，網站上的兩個結果來源無法共用名稱，但網站上的一個結果來源和網站集合提供的結果來源可以共用名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Owner
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定可定義對應結果來源可用範圍的搜尋物件擁有者。
參數屬性
| 類型: | SearchObjectOwner |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | o |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Password
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定用來連線到結果來源的使用者認證密碼。
如果未指定參數，則值不會變更。
當驗證類型 (AuthenticationType) 設定為取用使用者認證的類型 (FederationAuthType.SingleAccountBasicAuth、FederationAuthType.SingleAccountDigest 或 FederationAuthType.SingleAccountNTLM) 時使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ProviderId
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定結果來源要使用的搜尋提供者。
如果未指定參數，則值不會變更。
指定為 GUID 或 GUID 字串，必須是下列其中一項： FA947043-6046-4F97-9714-40D4C113963D (本機 SharePoint 搜尋) ，E4BCC058-F133-4425-8FFC-1D70596FFD33 (本機 SharePoint People搜尋) ， 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (遠端 SharePoint 搜尋) ， E377CAAA-FCAF-4A1b-B7A1-E69A506A07AA (遠端 SharePoint People搜尋) ,3A17E140-1574-4093-BAD6-E19CDF1C0122 (Exchange 搜尋) ,3A17E140-1574-4093-BAD6-E19CDF1C0121 (OpenSearch 1.0/1.1) 。
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QueryTemplate
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定結果來源的查詢轉換範本。
如果未指定參數，則值不會變更。
傳入查詢會根據範本變更，以改用這個新的查詢文字。 使用查詢變數 “{searchTerms}” 在新文字中包含傳入查詢。 用它來設定結果範圍。
例如，若只傳回 OneNote 項目，請將新的文字設定為 “{searchTerms} fileextension=one”。 然後，傳入查詢 “sharepoint” 會變成 “sharepoint fileextension=one”。 預設值為 {searchTerms}。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoteUrl
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定結果來源的連線 URL 範本。
如果未指定參數，則值不會變更。
使用使用它的搜尋提供者時必須設定：遠端 SharePoint 搜尋、遠端 SharePoint People搜尋、OpenSearch 1.0/1.1 和 Exchange (，如果自動探索未開啟) 。
使用其他搜尋提供者時，參數會遭到忽略。
針對遠端 SharePoint 搜尋/遠端 SharePoint People 搜尋，請指定遠端 SharePoint 陣列的根網站集合位址。
針對 OpenSearch 1.0/1.1，請指定 OpenSearch 來源的 URL。
使用查詢變數 “{searchTerms}” 在 URL 中包含查詢，它會自動以查詢取代。 針對 Exchange，指定要從中擷取結果的 Exchange EWS URL。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SearchApplication
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定搜尋應用程式。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID；有效的搜尋應用程式名稱 (例如 SearchApp1)；或有效之 SearchServiceApplication 物件的執行個體。
參數屬性
| 類型: | SearchServiceApplicationPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SsoId
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定用來連線至結果來源的反向 Proxy 憑證安全存放區識別碼。
如果未指定參數，則值不會變更。
如果驗證類型 (AUthenticationType) 設定為 FederationAuthType.SSO (單一登入) ，則必須指定。
如果您是透過反向 Proxy 連線到內部網路，請輸入單一登入項目的 SSO 識別碼，以儲存用來針對反向 Proxy 進行驗證的憑證。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UserName
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定用來連線到結果來源的使用者認證的使用者名稱。
如果未指定參數，則值不會變更。
當驗證類型 (AuthenticationType) 設定為取用使用者認證的類型 (FederationAuthType.SingleAccountBasicAuth、FederationAuthType.SingleAccountDigest 或 FederationAuthType.SingleAccountNTLM) 時使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。