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 支援與透過管理中心的 [管理結果來源] 頁面所支援的相同更新作業。 除了使用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
適用：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 支援下列一組驗證機制和對應的類型：Default SharePoint Authentication (FederationAuthType.LocalNTAuth) 、Basic Authentication (FederationAuthType.SingleAccountBasicAuth - 指定 UserName 和 Password) 、Default Remote SharePoint Authentication (FederationAuthType.PerUserBasicAuth) 、單一登入 (FederationAuthType.SSO - 需要指定 SsoId) 、 匿名 (FederationAuthType.Anonymous) 、摘要驗證 (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 列舉中。
參數屬性
| 類型: | 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
指定要更新的結果來源。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID 字符串;結果來源的有效名稱 (例如「自定義 SharePoint 結果來源」) ;或有效Source對象的實例。
參數屬性
| 類型: | 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 字串標識符作為 Identity，以明確指定 Owner 僅用於指定當值為 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 人員 搜尋) 、 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) 。
參數屬性
| 類型: | 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 人員 搜尋、OpenSearch 1.0/1.1，以及如果自動探索未在) 開啟，則為 Exchange (。
使用其他搜尋提供者時，會忽略 參數。
針對 [遠端 SharePoint 搜尋]/[遠端 SharePoint 人員 搜尋]，指定遠端 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 憑證 Secure Store Id。
如果未指定參數，則值會保持不變。
如果 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 |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。