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

New-AzSqlDatabaseInstanceFailoverGroup

模块:: Az.Sql Module

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

语法

Default （默认值）

New-AzSqlDatabaseInstanceFailoverGroup
    [-Name] <String>
    [-PartnerResourceGroupName <String>]
    -PartnerRegion <String>
    -PrimaryManagedInstanceName <String>
    -PartnerManagedInstanceName <String>
    [-PartnerSubscriptionId <String>]
    [-FailoverPolicy <String>]
    [-GracePeriodWithDataLossHours <Int32>]
    [-AllowReadOnlyFailoverToPrimary <String>]
    [-SecondaryType <String>]
    [-ResourceGroupName] <String>
    [-Location] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

使用指定的托管实例对在指定区域之间创建新的Azure SQL 数据库实例故障转移组。

在 Name.SqlDatabaseDnsSuffix（例如，Name.database.windows.net）和 Name.secondary.SqlDatabaseDnsSuffix 上创建了两个Azure SQL 数据库 TDS 终结点。这些终结点可用于分别连接到故障转移组的主要区域和次要区域。如果主要区域受中断影响，则会根据实例故障转移组的故障转移策略和宽限期触发终结点和数据库的自动故障转移。

在实例故障转移组功能的预览期间，“-GracePeriodWithDataLossHours”参数仅支持大于或等于 1 小时的值。

示例

示例 1

$failoverGroup = New-AzSqlDatabaseInstanceFailoverGroup -Name fgName -Location location -ResourceGroupName rg -PrimaryManagedInstanceName $managedInstance.Name -PartnerRegion $partnerRegion -PartnerManagedInstanceName $partnerManagedInstance.Name -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

ResourceGroupName                     : rg
Location                              : East US
Name                                  : fg
PartnerResourceGroupName              : rg
PartnerRegion                         : West US
PrimaryManagedInstanceName            : managedInstance1
PartnerManagedInstanceName            : managedInstance2
ReplicationRole                       : Primary
ReplicationState                      : CATCH_UP
ReadWriteFailoverPolicy               : Automatic
FailoverWithDataLossGracePeriodHours  : 1
ReadOnlyFailoverPolicy                : Disabled
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg/providers/Microsoft.Sql/locations/eastus/instanceFailoverGroups/fg

此命令为托管实例对创建具有故障转移策略“自动”的新实例故障转移组。

示例 2

$failoverGroup = New-AzSqlDatabaseInstanceFailoverGroup -Name fgName -Location location -ResourceGroupName rg -PrimaryManagedInstanceName $managedInstance.Name -PartnerRegion $partnerRegion -PartnerManagedInstanceName $partnerManagedInstance.Name -FailoverPolicy Manual

ResourceGroupName                     : rg
Location                              : East US
Name                                  : fg
PartnerResourceGroupName              : rg
PartnerRegion                         : West US
PrimaryManagedInstanceName            : managedInstance1
PartnerManagedInstanceName            : managedInstance2
ReplicationRole                       : Primary
ReplicationState                      : CATCH_UP
ReadWriteFailoverPolicy               : Manual
FailoverWithDataLossGracePeriodHours  :
ReadOnlyFailoverPolicy                : Disabled
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg/providers/Microsoft.Sql/locations/eastus/instanceFailoverGroups/fg

此命令为托管实例对创建具有故障转移策略“手动”的新实例故障转移组。

示例 3

此命令将创建新的Azure SQL 数据库实例故障转移组。 (autogenerated)

New-AzSqlDatabaseInstanceFailoverGroup -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1 -Location location -Name fgName -PartnerManagedInstanceName $partnerManagedInstance.Name -PartnerRegion $partnerRegion -PartnerResourceGroupName rg2 -PrimaryManagedInstanceName $managedInstance.Name -ResourceGroupName rg

参数

-AllowReadOnlyFailoverToPrimary

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-FailoverPolicy

实例故障转移组的故障转移策略。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-GracePeriodWithDataLossHours

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Location

要从中检索实例故障转移组的本地区域的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	2
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartnerManagedInstanceName

要添加到实例故障转移组的合作伙伴区域中托管实例的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartnerRegion

实例故障转移组的合作伙伴区域的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartnerResourceGroupName

实例故障转移组的辅助资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartnerSubscriptionId

实例故障转移组的辅助托管实例的订阅 ID。此参数仅用于跨订阅设置

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PrimaryManagedInstanceName

要添加到实例故障转移组的本地区域中托管实例的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SecondaryType

辅助实例的预期用法。备用状态表示辅助实例将用作被动副本，以便仅进行灾难恢复。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	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。

通过

New-AzSqlDatabaseInstanceFailoverGroup

语法

Default （默认值）

说明

示例

示例 1

示例 2

示例 3

参数

-AllowReadOnlyFailoverToPrimary

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-FailoverPolicy

参数属性

参数集

-GracePeriodWithDataLossHours

参数属性

参数集

-Location

参数属性

参数集

-Name

参数属性

参数集

-PartnerManagedInstanceName

参数属性

参数集

-PartnerRegion

参数属性

参数集

-PartnerResourceGroupName

参数属性

参数集

-PartnerSubscriptionId

参数属性

参数集

-PrimaryManagedInstanceName

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-SecondaryType

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

String

输出

AzureSqlInstanceFailoverGroupModel

反馈