Add-SqlAvailabilityDatabase

模块:

SQLServer

将主数据库添加到可用性组或将辅助数据库联接到可用性组。

语法

Add-SqlAvailabilityDatabase
   -Database <String[]>
   [[-Path] <String[]>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlAvailabilityDatabase
   -Database <String[]>
   [-InputObject] <AvailabilityGroup[]>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Add-SqlAvailabilityDatabase cmdlet 将主数据库添加到可用性组或将辅助数据库联接到可用性组。 InputObject 或 Path 参数指定可用性组。 一个数据库只能属于一个可用性组。

若要将数据库添加到可用性组，请在承载主副本 (replica) 的服务器实例上运行此 cmdlet。 指定一个或多个本地用户数据库。

若要将辅助数据库加入可用性组，请在承载辅助副本 (replica) 的服务器实例上手动准备辅助数据库。 然后在托管辅助副本 (replica) 的服务器实例上运行此 cmdlet。

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

示例

示例 1：将数据库添加到可用性组

PS C:\> Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16"

此命令将数据库“Database16”添加到可用性组“MainAG”。 在可用性组的主服务器实例上运行此命令。 此命令不会为数据同步准备辅助数据库。

示例 2：将数据库加入可用性组

PS C:\> Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16"

此命令将名为“Database16”的辅助数据库联接到承载辅助副本 (replica) 的某个服务器实例上的可用性组“MainAG”。

示例 3：添加数据库并将辅助数据库加入可用性组

PS C:\> $DatabaseBackupFile = "\\share\backups\Database16.bak"
PS C:\> $LogBackupFile = "\\share\backups\Database16.trn"
PS C:\> $AGPrimaryPath = "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
PS C:\> $MyAGSecondaryPath = "SQLSERVER:\SQL\SecondaryServer\InstanceName\AvailabilityGroups\MainAG"
PS C:\> Backup-SqlDatabase -Database "Database16" -BackupFile $DatabaseBackupFile -ServerInstance "PrimaryServer\InstanceName"
PS C:\> Backup-SqlDatabase -Database "Database16" -BackupFile $LogBackupFile -ServerInstance "PrimaryServer\InstanceName" -BackupAction Log
PS C:\> Restore-SqlDatabase -Database "Database16" -BackupFile $DatabaseBackupFile -ServerInstance "SecondaryServer\InstanceName" -NoRecovery
PS C:\> Restore-SqlDatabase -Database "Database16" -BackupFile $LogBackupFile -ServerInstance "SecondaryServer\InstanceName" -RestoreAction Log -NoRecovery
PS C:\> Add-SqlAvailabilityDatabase -Path $AGPrimaryPath -Database 'Database16'
PS C:\> Add-SqlAvailabilityDatabase -Path $AGSecondaryPath -Database "Database16"

此示例从承载可用性组的主副本 (replica) 的服务器实例上的数据库准备辅助数据库。 它将数据库作为主数据库添加到可用性组。最后，它将辅助数据库加入可用性组。

第六个命令将主服务器上“Database16”的日志文件备份到 $LogBackupFile 中的位置。

示例 4：创建脚本以将数据库添加到可用性组

PS C:\> Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16" -Script

此命令创建一个 Transact-SQL 脚本，用于将数据库“Database16”添加到可用性组“MainAG”。

参数

-AccessToken

用于对SQL Server进行身份验证的访问令牌，作为用户/密码或 Windows 身份验证的替代方法。

例如，这可用于连接到 SQL Azure DB 并使用 SQL Azure Managed InstanceService Principal 或 Managed Identity。

要使用的参数可以是表示令牌的字符串，也可以是 PSAccessToken 运行 Get-AzAccessToken -ResourceUrl https://database.windows.net返回的对象。

此参数是模块 v22 中的新增参数。

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

指定用户数据库的数组。 此 cmdlet 将此参数指定的数据库添加或联接到可用性组。 指定的数据库必须驻留在 SQL Server 的本地实例上。

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypt

连接到SQL Server时使用的加密类型。

此值映射到 Encrypt Microsoft.Data.SqlClient 驱动程序的 SqlConnection 对象上的 属性 SqlConnectionEncryptOption 。

在模块的 v22 中，默认 Optional 为 (，以便与 v21) 兼容。 在模块的 v23+ 中，默认值为“Mandatory”，这可能会为现有脚本创建中断性变更。

此参数是模块 v22 中的新增参数。

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

验证 SQL Server TLS/SSL 证书时要使用的主机名。 如果为 SQL Server 实例启用了强制加密，并且想要使用主机名/shortname 连接到实例，则必须传递此参数。 如果省略此参数，则必须将完全限定的域名 (FQDN) 传递给 -ServerInstance 才能连接到为强制加密启用的 SQL Server 实例。

此参数是模块 v22 中的新增参数。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定可用性组，作为可用性组对象，此 cmdlet 向其添加或联接数据库。

Type:	AvailabilityGroup[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

指定此 cmdlet 向其添加或联接数据库的可用性组的路径。 如果未指定此参数，此 cmdlet 将使用当前工作位置。

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

指示此 cmdlet 返回执行此 cmdlet 执行的任务的 Transact-SQL 脚本。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

指示是否在绕过证书链以验证信任时对通道进行加密。

在模块的 v22 中，默认 $true 为 (，以便与 v21) 兼容。 在模块的 v23+ 中，默认值为“$false”，这可能会为现有脚本创建中断性变更。

此参数是模块 v22 中的新增参数。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

System.String[], Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]

输出

System.Object

相关链接

• Backup-SqlDatabase
• Remove-SqlAvailabilityDatabase
• Restore-SqlDatabase
• Resume-SqlAvailabilityDatabase
• Suspend-SqlAvailabilityDatabase