New-SPEnterpriseSearchResultSource

  • 参考
模块:
sharepoint-server
适用于:
SharePoint Server Subscription Edition

创建新的结果源。

语法

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

说明

此 cmdlet 可创建结果源。 使用结果源确定搜索结果的范围并将查询汇总到外部源，例如 Internet 搜索引擎。 定义结果源后，配置搜索 Web 部件及使用它的查询规则操作。 结果源将取代搜索范围（现已弃用）。 此 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 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。 如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

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

-AutoDiscover

指定是否对新的结果源使用 Exchange 服务器终结点的自动发现。

将值设置为 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 Subscription Edition

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

-Description

指定新结果源的说明。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-MakeDefault

指定对于 Owner 参数指定的范围，是否应将新结果源设置为默认结果源。

将值设置为 ($true) 表明应将结果源设置为默认结果源。 如果未指定或设置为 false，则不会将新结果源设置为默认值。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Name

指定新结果源的名称。

名称在每个管理级别必须唯一。

例如，一个网站中的两个结果源不能使用同一个名称，但网站中的结果源可以与网站集提供的结果源使用同一个名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Owner

指定用于定义创建相应结果源的范围的搜索对象所有者。

Type:SearchObjectOwner
Aliases:o
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

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

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

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

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

-SearchApplication

指定搜索应用程序。

类型必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh;有效的搜索应用程序名称，例如 SearchApp1 或有效 SearchServiceApplication 对象的实例。

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SsoId

指定要用于连接到新结果源的反向代理证书安全存储 ID。

身份验证类型 (AuthenticationType) 设置为 FederationAuthType.SSO（单一登录）时必须指定。

如果您通过反向代理连接到 Intranet，请输入单一登录条目的 SSO ID，其中存储了用于对反向代理进行身份验证的证书。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

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

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