你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzSqlDatabaseFailoverGroup

此命令将创建新的Azure SQL 数据库故障转移组。

语法

New-AzSqlDatabaseFailoverGroup
   [-ServerName] <String>
   -FailoverGroupName <String>
   [-PartnerSubscriptionId <String>]
   [-PartnerResourceGroupName <String>]
   -PartnerServerName <String>
   [-FailoverPolicy <FailoverPolicy>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
   [-PartnerServerList <System.Collections.Generic.List`1[System.String]>]
   [-ReadOnlyEndpointTargetServer <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

为指定的服务器创建新的 Azure SQL 数据库故障转移组。 在 FailoverGroupName.SqlDatabaseDnsSuffix(例如,FailoverGroupName.database.windows.net)和 FailoverGroupName.secondary.SqlDatabaseDnsSuffix 上创建了两个Azure SQL 数据库 TDS 终结点。 这些终结点可用于分别连接到故障转移组中的主服务器和辅助服务器。 如果主服务器受中断影响,则会根据故障转移组的故障转移策略和宽限期触发终结点和数据库的自动故障转移。 新建的故障转移组不包含任何数据库。 若要控制故障转移组中的数据库集,请使用“Add-AzSqlDatabaseToFailoverGroup”和“Remove-AzSqlDatabaseFromFailoverGroup”cmdlet。 “-GracePeriodWithDataLossHours”参数仅支持大于或等于 1 小时的值。

[!注意] 从 Az.SQL 3.11.0 开始,可以在 Azure Powershell 中使用 -PartnerSubscriptionId 参数跨订阅部署自动故障转移组。

示例

示例 1

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

此命令为同一资源组中的两台服务器创建新的故障转移组,其故障转移策略为“自动”。

示例 2

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual

此命令为不同资源组中的两台服务器创建新的故障转移组,其故障转移策略为“手动”。

示例 3

$sub2 = 'b3c40cd6-024f-428c-921b-cda6c6834c34'
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ServerName primaryserver -FailoverGroupName fg -PartnerSubscriptionId $sub2 -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverPolicy Manual -ResourceGroupName rg1

FailoverGroupName                    : fg
Location                             : East US
ResourceGroupName                    : rg1
ServerName                           : primaryserver
PartnerLocation                      : West US 2
PartnerResourceGroupName             : rg2
PartnerServerName                    : secondaryserver1
ReplicationRole                      : Primary
ReplicationState                     : CATCH_UP
ReadWriteFailoverPolicy              : Manual
FailoverWithDataLossGracePeriodHours :
DatabaseNames                        : {}

此命令为不同订阅中的两台服务器创建新的故障转移组,其故障转移策略为“手动”。

参数

-AllowReadOnlyFailoverToPrimary

辅助服务器上的中断是否应触发只读终结点的自动故障转移。

类型:AllowReadOnlyFailoverToPrimary
接受的值:Enabled, Disabled
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FailoverGroupName

要创建的Azure SQL 数据库故障转移组的名称。

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

-FailoverPolicy

Azure SQL 数据库故障转移组的故障转移策略。

类型:FailoverPolicy
接受的值:Automatic, Manual
Position:Named
默认值:Manual
必需:False
接受管道输入:False
接受通配符:False

-GracePeriodWithDataLossHours

如果在主服务器上发生中断且故障转移无法完成且无法完成数据丢失,则启动自动故障转移之前的间隔。

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

-PartnerResourceGroupName

Azure SQL 数据库故障转移组的辅助资源组的名称。

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

-PartnerServerList

故障转移组中的合作伙伴服务器列表(0 台服务器的空列表)。

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

-PartnerServerName

Azure SQL 数据库故障转移组的辅助服务器的名称。

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

-PartnerSubscriptionId

Azure SQL 数据库故障转移组的辅助订阅 ID 的名称。

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

-ReadOnlyEndpointTargetServer

只读终结点的目标服务器的名称。 如果为空,则默认为 PartnerServerName 的值。

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

-ResourceGroupName

资源组的名称。

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

-ServerName

故障转移组的主Azure SQL 数据库服务器的名称。

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

输入

String

输出

AzureSqlFailoverGroupModel