New-SPEnterpriseSearchServiceApplication

向服务器场添加 Search Service 应用程序。

语法

New-SPEnterpriseSearchServiceApplication
   [[-Name] <String>]
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseName <String>]
   [-DatabasePassword <SecureString>]
   [-DatabaseServer <String>]
   [-DatabaseUsername <String>]
   [-Partitioned]
   [-WhatIf]
   [-AdminApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-CloudIndex <Boolean>]
   [-FailoverDatabaseServer <String>]
   [<CommonParameters>]

说明

在首次配置搜索功能或向服务器场添加新的共享搜索应用程序时,可使用此 cmdlet。 SPEnterpriseSearchServiceApplication 表示可用于搜索的索引内容和属性的独立聚合,并提供用于设置全局搜索属性的定位点类。 一个服务器场可以包含多个 Search Service 应用程序。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

------------------示例 1------------------

$appPool = New-SPServiceApplicationPool -Name 'SharePoint Web Services Default' -Account 'CONTOSO\ServiceApps'
New-SPEnterpriseSearchServiceApplication -Name "Search Service Application" -ApplicationPool $appPool

本示例在新的应用程序池中创建名为 NewSSA 的新搜索服务应用程序。

以这种方式创建的 Search Service 应用程序将具有活动的搜索拓扑,但是没有搜索组件。

------------------示例 2------------------

$appPool = New-SPServiceApplicationPool -Name 'SharePoint Web Services Default' -Account 'CONTOSO\ServiceApps' 
New-SPEnterpriseSearchServiceApplication -Name "Search Service Application" -ApplicationPool $appPool -DatabaseName SearchServiceAppDB

此示例在新的应用程序池中创建名为 NewSSA 的新搜索服务应用程序,并指定数据库的名称。

以这种方式创建的 Search Service 应用程序将具有活动的搜索拓扑,但是没有搜索组件。

参数

-AdminApplicationPool

指定与 SearchServiceApplication 相关的 SearchAdminWebServiceApplication 将使用的应用程序池。 如果未指定,将使用 ApplicationPool。

Type:SPIisWebServiceApplicationPoolPipeBind
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

-ApplicationPool

指定要用于新搜索应用程序的 IIS 应用程序池。

类型必须是有效的 GUID,格式为 12345678-90ab-cdef-1234-567890bcdefgh;搜索应用程序的有效 URL,格式 https://server_name为 ;或有效 SPIisWebServiceApplicationPool 对象的实例。

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CloudIndex

如果 CloudIndex 为 true,则变为对云混合搜索解决方案中的本地内容进行爬网的云搜索服务应用程序。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-DatabaseName

指定将为新搜索应用程序创建的数据库的名称。

类型必须是SQL Server数据库的有效名称,例如 SearchAppDB1。

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

-DatabasePassword

指定用于访问SQL Server上的搜索应用程序数据库的用户 ID 的密码。

键入的值必须是有效的密码。

Type:SecureString
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

-DatabaseServer

指定在 DatabaseName 中指定的数据库的主机服务器名称。

类型必须是有效的SQL Server主机名,例如 SQLServerHost1。

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

-DatabaseUsername

指定用于访问搜索应用程序SQL Server数据库的用户 ID。

键入的值必须为有效的用户名,例如 SearchUserName1。

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

-FailoverDatabaseServer

指定托管搜索数据库的镜像实例的 SQL 服务器的名称。

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

-Name

指定新搜索应用程序的名称。

键入的值必须为搜索应用程序的有效名称,例如 SearchApp1。

Type:String
Position:1
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

-Partitioned

指定 Search Service 应用程序使用 Web 托管模式。 Web 托管模式可隔离给定托管订阅的结果。

此属性对SharePoint Server 2019没有影响。

Type:SwitchParameter
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