你当前正在访问 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 |