New-AzSqlDatabaseFailoverGroup

  • リファレンス
モジュール:
Az.Sql

このコマンドにより、新しい Azure SQL Database フェールオーバー グループが作成されます。

構文

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 パラメーターを使用して、サブスクリプション間で自動フェールオーバー グループをデプロイできます。

例

例 1

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

このコマンドは、同じリソース グループ内の 2 つのサーバーに対して、フェールオーバー ポリシー "自動" を持つ新しいフェールオーバー グループを作成します。

例 2

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

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

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

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

パラメーター

-AllowReadOnlyFailoverToPrimary

セカンダリ サーバーで障害が発生した場合に、読み取り専用エンドポイントの自動フェールオーバーをトリガーする必要があるかどうか。

Type:AllowReadOnlyFailoverToPrimary
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailoverGroupName

作成する Azure SQL Database フェールオーバー グループの名前。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FailoverPolicy

Azure SQL Database フェールオーバー グループのフェールオーバー ポリシー。

Type:FailoverPolicy
Accepted values:Automatic, Manual
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GracePeriodWithDataLossHours

プライマリ サーバーで障害が発生し、データが失われなければフェールオーバーを完了できない場合に、自動フェールオーバーが開始されるまでの間隔。

Type:Int32
Position:Named
Default value:1
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerResourceGroupName

Azure SQL Database フェールオーバー グループのセカンダリ リソース グループの名前。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServerList

フェールオーバー グループ内のパートナー サーバーの一覧 (0 台のサーバーの空の一覧)。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServerName

Azure SQL Database フェールオーバー グループのセカンダリ サーバーの名前。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartnerSubscriptionId

Azure SQL Database フェールオーバー グループのセカンダリ サブスクリプション ID の名前。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReadOnlyEndpointTargetServer

読み取り専用エンドポイントのターゲット サーバーの名前。 空の場合、既定では PartnerServerName の値になります。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソース グループの名前。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

フェールオーバー グループのプライマリ Azure SQL Database Server の名前。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

String

出力

AzureSqlFailoverGroupModel