New-SPConfigurationDatabase

创建新的配置数据库。

语法

New-SPConfigurationDatabase
   [-DatabaseName] <String>
   [-DatabaseServer] <String>
   [[-DirectoryDomain] <String>]
   [[-DirectoryOrganizationUnit] <String>]
   [[-AdministrationContentDatabaseName] <String>]
   [[-DatabaseCredentials] <PSCredential>]
   [-FarmCredentials] <PSCredential>
   [-Passphrase] <SecureString>
   [-SkipRegisterAsDistributedCacheHost]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-DatabaseFailOverServer <String>]
   [-LocalServerRole <SPServerRole>]
   [-ServerRoleOptional]
   [-DatabaseConnectionEncryption <SqlConnectionEncryptOption>]
   [-DatabaseServerCertificateHostName <String>]
   [<CommonParameters>]

说明

New-SPConfigurationDatabase cmdlet 在指定的数据库服务器上创建新的配置数据库。 这是新的 SharePoint 服务器场的中心数据库。

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

示例

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

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential)

此示例提示用户提供默认服务器场管理员帐户的用户凭据。

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

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -SkipRegisterAsDistributedCacheHost

此示例提示用户提供默认场管理员帐户的用户凭据,并跳过将服务器注册为分布式缓存主机。 仅适用于 SharePoint Server 2013 和 SharePoint Server 2016,SharePoint Server 2019。

------------------示例 3-----------------------

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -LocalServerRole Custom

此示例提示用户提供默认场管理员帐户的用户凭据,并将“服务器角色”设置为“自定义”。 仅适用于 SharePoint Server 2016,SharePoint Server 2019。

参数

-AdministrationContentDatabaseName

指定新服务器场的管理中心内容数据库的名称。 如果未指定任何名称,则使用默认名称。

类型:String
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-AssignmentCollection

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

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

类型:SPAssignmentCollection
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DatabaseConnectionEncryption

指定是否对 SharePoint 与数据库之间的连接使用 TLS 加密。 强制要求使用 TLS 加密。 如果无法成功协商 TLS 加密,连接将失败。 可选允许使用 TLS 加密。 如果数据库服务器需要 TLS 加密,则将使用 TLS 加密。 否则,将不会使用 TLS 加密。 严格要求将 TLS 加密与 TDS 8.0 一起使用,TDS 8.0 是最强的加密配置。 如果无法成功协商使用 TDS 8.0 进行 TLS 加密,连接将失败。 安装版本 24H2 功能更新之前装载到 SharePoint 的数据库默认为可选加密。 如果在安装版本 24H2 功能更新后将新数据库装载到 SharePoint 时未指定此参数,则默认值为“必需”。

类型:SqlConnectionEncryptOption
Position:Named
默认值:Mandatory
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DatabaseCredentials

指定数据库用户的 Credential 对象。 如果使用 SQL Server 身份验证,则使用此参数。 如果未提供数据库凭据,则使用 Windows 身份验证。

类型:PSCredential
Position:6
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DatabaseFailOverServer

为配置和管理中心数据库指定SQL Server数据库镜像伙伴服务器。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DatabaseName

指定新配置数据库的名称。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DatabaseServer

指定在其上创建配置数据库的数据库服务器。 如果未指定任何值,则使用默认值。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DatabaseServerCertificateHostName

设置验证连接的服务器证书时要使用的主机名。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DirectoryDomain

指定新服务器场的目录域。 如果未指定任何域,则使用本地计算机所在的域。

类型:String
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-DirectoryOrganizationUnit

指定新配置数据库的目录组织单位。 如果未指定任何组织单位,则使用本地计算机所在的组织单位。

类型:String
Position:4
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-FarmCredentials

指定服务器场管理员帐户的凭据。

类型:PSCredential
Position:7
默认值:None
必需:True
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-LocalServerRole

指定服务器角色。 所有版本的 SharePoint Server 2016 的有效选项,SharePoint Server 2019为:Custom、、SingleServerFarmApplicationWebFrontEndDistributedCacheSearch

添加了功能包 1 后,新选项包括: ApplicationWithSearchWebFrontEndWithDistributedCache

类型:SPServerRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:SharePoint Server Subscription Edition

-Passphrase

指定新服务器场的安全密码短语。 此密码用于将其他计算机加入此服务器场。

类型:SecureString
Position:8
默认值:None
必需:True
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition

-ServerRoleOptional

将服务器场配置为不需要指定服务器角色。 如果未指定服务器角色,则服务器默认为自定义角色。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:SharePoint Server Subscription Edition

-SiteMapDatabaseName

请勿使用。 指定“站点地图”站点的数据库名称。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:SharePoint Server Subscription Edition

-SiteMapDatabaseServer

请勿使用。 指定“站点地图”站点的数据库服务器名称。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:SharePoint Server Subscription Edition

-SkipRegisterAsDistributedCacheHost

默认情况下,服务器场中的所有服务器均注册为缓存主机(即,默认情况下运行 DistributedCacheService )。

使用此参数不会将服务器计算机注册为分布式缓存主机。 如果要具有专用缓存主机,则使用此参数可确保计算机上不安装缓存服务。

类型:SwitchParameter
Position:9
默认值:None
必需:False
接受管道输入:True
接受通配符:False
适用于:SharePoint Server Subscription Edition