New-AzureRmSqlDatabaseFailoverGroup

リファレンス

モジュール:: AzureRM.Sql

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRmSqlDatabaseFailoverGroup
   [-ServerName] <String>
   -FailoverGroupName <String>
   [-PartnerResourceGroupName <String>]
   -PartnerServerName <String>
   [-FailoverPolicy <FailoverPolicy>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

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

例

例 1

C:\> $failoverGroup = New-AzureRMSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

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

例 2

C:\> $failoverGroup = New-AzureRMSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual

このコマンドは、異なるリソースグループ内の 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:	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

-PartnerServerName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
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