次の方法で共有


New-AzSqlDatabaseInstanceFailoverGroup

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

構文

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>]

説明

指定したリージョン間に、指定された Managed Instance ペアを持つ新しい Azure SQL Database インスタンス フェールオーバー グループを作成します。

Name.SqlDatabaseDnsSuffix (たとえば、Name.database.windows.net) と Name.secondary.SqlDatabaseDnsSuffix に 2 つの Azure SQL Database 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

このコマンドは、Managed Instance ペアのフェールオーバー ポリシー "自動" を使用して、新しいインスタンス フェールオーバー グループを作成します。

例 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 Database インスタンス フェールオーバー グループが作成されます。 (自動生成)

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

パラメーター

-AllowReadOnlyFailoverToPrimary

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FailoverPolicy

インスタンス フェールオーバー グループのフェールオーバー ポリシー。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-GracePeriodWithDataLossHours

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

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Location

インスタンス フェールオーバー グループの取得元となるローカル リージョンの名前。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerManagedInstanceName

インスタンス フェールオーバー グループに追加するパートナー リージョン内のマネージド インスタンスの名前。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerRegion

インスタンス フェールオーバー グループのパートナー リージョンの名前。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerResourceGroupName

インスタンス フェールオーバー グループのセカンダリ リソース グループの名前。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerSubscriptionId

インスタンス フェールオーバー グループのセカンダリ マネージド インスタンスのサブスクリプション ID。 このパラメーターは、サブスクリプション間のセットアップにのみ必要です

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrimaryManagedInstanceName

インスタンス フェールオーバー グループに追加するローカル リージョン内のマネージド インスタンスの名前。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceGroupName

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SecondaryType

セカンダリ インスタンスの使用目的。 スタンバイは、セカンダリ インスタンスがディザスター リカバリー専用のパッシブ レプリカとして使用されることを示します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

出力

AzureSqlInstanceFailoverGroupModel