New-AzSqlDatabaseFailoverGroup

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 Database フェールオーバー グループを作成します。 FailoverGroupName.SqlDatabaseDnsSuffix (たとえば、FailoverGroupName.database.windows.net) と FailoverGroupName.secondary.SqlDatabaseDnsSuffix に、2 つの Azure SQL Database TDS エンドポイントが作成されます。 これらのエンドポイントは、それぞれフェールオーバー グループ内のプライマリ サーバーとセカンダリ サーバーに接続するために使用できます。 プライマリ サーバーが停止の影響を受ける場合、フェールオーバー グループのフェールオーバー ポリシーと猶予期間によって指示されたとおりに、エンドポイントとデータベースの自動フェールオーバーがトリガーされます。 新しく作成されたフェールオーバー グループには、データベースは含まれません。 フェールオーバー グループ内のデータベースのセットを制御するには、'Add-AzSqlDatabaseToFailoverGroup' コマンドレットと 'Remove-AzSqlDatabaseFromFailoverGroup' コマンドレットを使用します。 '-GracePeriodWithDataLossHours' パラメーターでは、1 時間以上の値のみがサポートされます。

[!注] Az.SQL 3.11.0 以降の Azure Powershell で -PartnerSubscriptionId パラメーターを使用して、サブスクリプション間で自動フェールオーバー グループをデプロイ。

$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

このコマンドは、異なるリソース グループ内の 2 つのサーバーに対して、フェールオーバー ポリシー "手動" を使用して新しいフェールオーバー グループを作成します。

$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                        : {}

このコマンドは、異なるサブスクリプション内の 2 つのサーバーに対して、フェールオーバー ポリシー "手動" を使用して新しいフェールオーバー グループを作成します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。