New-SPEnterpriseSearchServiceApplication

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

语法

Default (默认值)

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

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SPIisWebServiceApplicationPoolPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ApplicationPool

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SPIisWebServiceApplicationPoolPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AssignmentCollection

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

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

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CloudIndex

适用:SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型: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

-DatabaseName

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabasePassword

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabaseServer

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabaseUsername

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FailoverDatabaseServer

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Partitioned

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SwitchParameter
默认值: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