New-AzSqlDatabaseInstanceFailoverGroup

リファレンス

モジュール:: Az.Sql

このコマンドにより、新しい 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

次の方法で共有