New-SqlAvailabilityGroup

模块:

SQLServer

创建可用性组。

语法

New-SqlAvailabilityGroup
   -AvailabilityReplica <AvailabilityReplica[]>
   [-Database <String[]>]
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-BasicAvailabilityGroup]
   [-ContainedAvailabilityGroup]
   [-ReuseSystemDatabases]
   [-DatabaseHealthTrigger]
   [-DtcSupportEnabled]
   [-ClusterType <AvailabilityGroupClusterType>]
   [-RequiredSynchronizedSecondariesToCommit <Int32>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-SqlAvailabilityGroup
   -AvailabilityReplica <AvailabilityReplica[]>
   [-Database <String[]>]
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-BasicAvailabilityGroup]
   [-ContainedAvailabilityGroup]
   [-ReuseSystemDatabases]
   [-DatabaseHealthTrigger]
   [-DtcSupportEnabled]
   [-ClusterType <AvailabilityGroupClusterType>]
   [-RequiredSynchronizedSecondariesToCommit <Int32>]
   [-Name] <String>
   [-InputObject] <Server>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-SqlAvailabilityGroup cmdlet 在 AlwaysOn 可用性组中创建可用性组。

InputObject 或 Path 参数指定承载初始主副本的服务器。

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

示例

示例 1：创建可用性组

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version) 
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

第一个命令获取主服务器上的 SQL Server 实例，然后将其存储在$PrimaryServer变量中。

第四个命令使用 New-SqlAvailabilityReplica 创建包含辅助服务器实例的副本，然后将其存储在$SecondaryReplica变量中。

该命令使用 $SecondaryServer 的 Version 属性指定服务器实例的版本。

示例 2：创建 WSFC 支持的可用性组

# Get server
PS C:\> cd 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD

# Create primary replica
PS SQLSERVER:\SQL\some-hostname\Default> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate

# Create AG with explicit cluster type WSFC (same as not passing -ClusterType, since it is the default value)
PS SQLSERVER:\SQL\some-hostname\Default> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -Script -ClusterType Wsfc

示例 3：创建独立于可用性组群集

# Get server
PS C:\> CD 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD

# Create primary replica
PS SQLSERVER:\SQL\some-hostname\Default> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate

# Create AG cluster group independent
PS SQLSERVER:\SQL\some-hostname\Default> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -Script -ClusterType None

示例 4：创建可用性组，设置SYNCHRONOUS_COMMIT辅助数据库的数目，这些辅助数据库必须可供事务在主服务器上提交

# Get server
PS C:\> Get-Item 'SQLSERVER:\SQL\some-hostname\Default'
# Create primary replica
PS C:\> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate
# Create AG with RequiredSynchronizedSecondariesToCommit = 3
PS C:\> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -RequiredSynchronizedSecondariesToCommit 3

注意：如果目标服务器版本为 SQL Server 2016 或更低版本时使用 -RequiredSynchronizedSecondariesToCommit 参数，将引发异常。

参数

-AccessToken

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

例如，这可用于使用 Service Principal 或 Managed Identity连接到 SQL Azure DB 和 SQL Azure Managed Instance。

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

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

类型:	PSObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AutomatedBackupPreference

指定可用性组的自动备份首选项。

此参数的可接受值为：

• 主要。 指定备份始终发生在主副本上。 此选项支持在次要副本（例如差异备份）上运行备份时不可用的功能。
• SecondaryOnly。 指定从不对主要副本执行备份。 如果主副本是唯一联机副本，则不会进行备份。
• 二 次。 指定次要副本上发生备份，除非主副本是联机唯一的副本。 然后，备份发生在主副本上。
• 没有。 指定在确定哪个副本执行备份时，不会考虑主要状态或辅助状态。 相反，备份优先级和联机状态决定了哪个副本执行备份。

类型:	AvailabilityGroupAutomatedBackupPreference
接受的值:	Primary, SecondaryOnly, Secondary, None, Unknown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AvailabilityReplica

指定此 cmdlet 包含在可用性组中的可用性副本数组。 若要获取 AvailabilityReplica，请使用 New-SqlAvailabilityReplica cmdlet。 指定 AsTemplate 参数。

类型:	AvailabilityReplica[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-BasicAvailabilityGroup

指定是创建 advanced（默认）还是 basic 可用性组。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClusterType

支持 AG 的群集类型。 可能的值包括：

• Wsfc。 AG 将集成到 Windows Server 故障转移群集中。 这是 SQL Server 2016 及更低版本中的 AG 的创建方式。 这是默认值。
• 没有。 AG 将独立于群集。
• 外部。 AG 将由不是 Windows Server 故障转移群集的群集管理器（如 Linux 上的 Pacemaker）管理。 SQL Server 2017 及更高版本支持此功能。 在 Linux 上面向 SQL Server 时，必须指定此值，否则会出现错误。

注意：如果目标服务器为 SQL Server 2016 及更低版本，将使用 -ClusterType 参数，则会引发异常。

类型:	AvailabilityGroupClusterType
接受的值:	Wsfc, None, External
Position:	Named
默认值:	Wsfc
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-ContainedAvailabilityGroup

用于创建包含的可用性组。 此选项用于创建具有自己的 master 和 msdb 数据库的可用性组，这些数据库在可用性组中的副本集中保持同步。 此参数可以与其配套 -ReuseSystemDatabases一起使用。

仅当目标 SQL Server 支持包含的可用性组（SQL 2022 及更高版本）时，才允许此参数。 尝试对不支持包含可用性组的 SQL 版本使用会导致 cmdlet 引发错误。

此参数仅在模块版本 22+ 中可用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Database

指定本地读/写用户数据库的数组。 这些数据库必须使用完整恢复模式，并且不得使用AUTO_CLOSE。 这些数据库不能属于另一个可用性组，并且无法为数据库镜像配置。 必须为此参数指定值。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatabaseHealthTrigger

指定在可用性组中的任何用户数据库副本遇到数据库故障条件时是否触发可用性组的自动故障转移。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DtcSupportEnabled

指定可用性组中的数据库是在实例级别（默认值）还是按数据库级别向 MSDTC 注册。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Encrypt

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

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

在模块的 v22 中，默认为 Optional（为了与 v21 兼容）。 在模块的 v23+ 中，默认值为“必需”，这可能会为现有脚本创建中断性变更。

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

类型:	String
接受的值:	Mandatory, Optional, Strict
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FailureConditionLevel

指定可用性组的自动故障转移行为。 此参数的可接受值为：

• OnServerDown。 如果 SQL Server 服务停止，则故障转移或重启。
• OnServerUnresponsive。 如果满足任何较低值条件，以及 SQL Server 服务连接到群集且超出 HealthCheckTimeout 阈值时，或者当前处于主要角色的可用性副本处于失败状态，则故障转移或重启。
• OnCriticalServerError。 如果满足任何较低值的条件，以及发生内部关键服务器错误（包括内存不足、严重写入访问冲突或转储过多）时，故障转移或重启。
• OnModerateServerError。 如果满足任何较低值条件，以及发生中等服务器错误（包括内存不足状态），则故障转移或重启。
• OnAnyQualifiedFailureConditions。 如果满足任何较低值的条件，以及发生符合条件的故障条件，则故障转移或重启，其中包括检测到引擎工作线程耗尽和无法解决的死锁。

类型:	AvailabilityGroupFailureConditionLevel
接受的值:	OnServerDown, OnServerUnresponsive, OnCriticalServerErrors, OnModerateServerErrors, OnAnyQualifiedFailureCondition, Unknown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HealthCheckTimeout

指定一段时间（以毫秒为单位），之后 Always On 可用性组将无响应服务器声明为不正常。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HostNameInCertificate

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

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定承载此 cmdlet 创建的可用性组的主要副本的 SQL Server 实例。

类型:	Server
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定此 cmdlet 创建的可用性组的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Path

指定承载此 cmdlet 创建的可用性组的初始主副本的 SQL Server 实例的路径。 如果未指定此参数，此 cmdlet 将使用当前工作位置。 如果指定值，则路径当前必须存在。

类型:	String
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProgressAction

确定 PowerShell 如何响应脚本、cmdlet 或提供程序生成的进度更新，例如由 Write-Progress cmdlet 生成的进度栏。 Write-Progress cmdlet 创建显示命令状态的进度栏。

类型:	ActionPreference
别名:	proga
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequiredSynchronizedSecondariesToCommit

必须可用于在主副本上提交的同步提交辅助数据库的数量。

如果 SYNCHRONOUS_COMMIT 辅助数据库与主数据库断开连接一段时间，则主要副本会将其降级为 ASYNCHRONOUS_COMMIT 以避免阻止提交。 如果主数据库变得不可用，并且用户希望故障转移到其中一个辅助数据库，则可能会导致数据丢失。 通过将 RequiredSynchronizedSecondariesToCommit 设置为某些数字 ，用户可以防止数据丢失，因为如果降级为 ，主副本将开始阻止提交。

此设置的默认值为 0，这意味着主数据库永远不会阻止提交。 这与 SQL Server 2017 之前的行为相同。

类型:	Int32
Position:	Named
默认值:	0
必需:	False
接受管道输入:	False
接受通配符:	False

-ReuseSystemDatabases

此参数会导致在创建此新可用性组时使用以前版本的 AG 中包含的 master 和 msdb 数据库。

如果不指定 -ContainedAvailabilityGroup，则尝试使用此参数将导致 cmdlet 引发错误。

此参数仅在模块版本 22+ 中可用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Script

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TrustServerCertificate

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

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

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.SqlServer.Management.Smo.Server

可以将服务器实例传递给此 cmdlet。

输出

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

此 cmdlet 返回可用性组。

相关链接

• Join-SqlAvailabilityGroup
• New-SqlAvailabilityReplica
• Remove-SqlAvailabilityGroup
• Set-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup