Add-SqlAvailabilityDatabase
将主数据库添加到可用性组或将辅助数据库联接到可用性组。
语法
ByPath （默认值）
Add-SqlAvailabilityDatabase
[[-Path] <String[]>]
-Database <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlAvailabilityDatabase
[-InputObject] <AvailabilityGroup[]>
-Database <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Add-SqlAvailabilityDatabase cmdlet 将主数据库添加到可用性组或将辅助数据库联接到可用性组。 InputObject 或 Path 参数指定可用性组。 数据库只能属于一个可用性组。
若要将数据库添加到可用性组，请在承载主副本的服务器实例上运行此 cmdlet。 指定一个或多个本地用户数据库。
若要将辅助数据库加入可用性组，请在承载辅助副本的服务器实例上手动准备辅助数据库。 然后在承载辅助副本的服务器实例上运行此 cmdlet。
示例
示例 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 的辅助数据库联接到托管辅助副本的服务器实例之一上的可用性组 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"
此示例从承载可用性组主副本的服务器实例上的数据库准备辅助数据库。 它将数据库作为主数据库添加到可用性组。 最后，它将辅助数据库加入可用性组。
前四个命令将路径存储在变量中，以供稍后在示例中使用。 这些命令将值分配给$DatabaseBackupFile、$LogBackupFile、$AGPrimaryPath和$AGSecondaryPath变量。
第五个命令将主服务器上名为 Database16 的数据库备份到$DatabaseBackupFile中的位置。
第六个命令将主服务器上的 Database16 日志文件备份到$LogBackupFile中的位置。
第七个命令在辅助服务器上还原 Database16 的数据库备份。
第八个命令在辅助服务器上还原 Database16 的日志文件。
第九个命令将数据库添加到主服务器上的可用性组。
最后一个命令将该副本的辅助数据库联接到可用性组。 如果有多个次要副本，请为每个辅助副本还原并加入辅助数据库。
示例 4：创建用于将数据库添加到可用性组的脚本
PS C:\>Add-SqlAvailabilityDatabase -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Database "Database16" -Script
此命令创建一个 Transact-SQL 脚本，该脚本将数据库 Database16 添加到可用性组 MainAG。
参数
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Database
指定用户数据库的数组。 此 cmdlet 添加或联接此参数指定到可用性组的数据库。 指定的数据库必须驻留在 SQL Server 的本地实例上。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-InputObject
指定可用性组（作为 AvailabilityGroup 对象），此 cmdlet 向其添加或联接数据库。
参数属性
| 类型: | AvailabilityGroup[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ByObject
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Path
指定此 cmdlet 向其添加或联接数据库的可用性组的路径。 如果未指定此参数，此 cmdlet 将使用当前工作位置。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ByPath
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Script
指示此 cmdlet 返回执行此 cmdlet 执行的任务的 Transact-SQL 脚本。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | 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。