共用方式為


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