Connect-SPConfigurationDatabase

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

将本地服务器计算机连接到服务器场。

语法

Connect-SPConfigurationDatabase
       [-DatabaseName] <String>
       [-SkipRegisterAsDistributedCacheHost]
       [-Passphrase] <SecureString>
       -DatabaseServer <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-DatabaseCredentials <PSCredential>]
       [-DatabaseFailOverPartner <String>]
       [-LocalServerRole <SPServerRole>]
       [-DatabaseConnectionEncryption <SqlConnectionEncryptOption>]
       [-DatabaseServerCertificateHostName <String>]
       [<CommonParameters>]

说明

Connect-SPConfigurationDatabase cmdlet 可将当前服务器连接到指定的配置数据库。

实质上，此 cmdlet 是将服务器连接到服务器场。如果无法将当前计算机连接到服务器场，将显示如下错误消息：

“此计算机已经连接到 SharePoint 场。请参见: Dismount-SPConfigurationDatabase”

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

示例

------------------示例------------------

Connect-SPConfigurationDatabase -DatabaseServer "ServerName\InstanceName" -DatabaseName "SharePointConfigurationDatabaseName" -Passphrase (ConvertTo-SecureString "MyP@ssw0rd" -AsPlainText -Force)
Start-Service SPTimerv4

此示例使用名称 ServerName\InstanceName 和密码 MyP@ssw0rd 将本地服务器计算机加入到服务器场中，该服务器场配置为使用 SQL Server 实例上的数据库 SharePointConfigurationDatabase。

参数

-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
必需:	True
接受管道输入:	True
接受通配符:	False
适用于:	SharePoint Server Subscription Edition

-DatabaseCredentials

指定包含用于数据库 SQL 身份验证的用户名和密码的 PSCredential 对象。如果未指定此参数，将使用当前用户。

键入的值必须是有效的 PSCredential 对象。

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

-DatabaseFailOverPartner

指定SQL Server实例的数据库镜像伙伴。

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

-DatabaseName

指定要连接到服务器的配置数据库的名称。

键入的值必须为有效的数据库名称；例如，DB1。

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

-DatabaseServer

指定要在其中创建配置数据库的服务器。默认值为本地计算机名称。

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

-DatabaseServerCertificateHostName

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

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

-LocalServerRole

指定分配给本地服务器的 MinRole。

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

-Passphrase

指定用于将当前服务器连接到配置数据库的安全密码。

键入的值必须为有效的安全字符串；例如，MyBDCApp1serverkey。

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

-SkipRegisterAsDistributedCacheHost

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

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

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

通过