New-AzureRmSqlDatabaseFailoverGroup
このコマンドにより、新しい 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
セカンダリ サーバーで障害が発生した場合に、読み取り専用エンドポイントの自動フェールオーバーをトリガーする必要があるかどうか。 この機能は、まだサポートされていません。
型: | AllowReadOnlyFailoverToPrimary |
指定可能な値: | Enabled, Disabled |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FailoverGroupName
作成する Azure SQL Database フェールオーバー グループの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FailoverPolicy
Azure SQL Database フェールオーバー グループのフェールオーバー ポリシー。
型: | FailoverPolicy |
指定可能な値: | Automatic, Manual |
配置: | Named |
規定値: | Automatic |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GracePeriodWithDataLossHours
プライマリ サーバーで障害が発生し、データが失われなければフェールオーバーを完了できない場合に、自動フェールオーバーが開始されるまでの間隔。
型: | Int32 |
配置: | Named |
規定値: | 1 |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PartnerResourceGroupName
Azure SQL Database フェールオーバー グループのセカンダリ リソース グループの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PartnerServerName
Azure SQL Database フェールオーバー グループのセカンダリ サーバーの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループの名前。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ServerName
フェールオーバー グループのプライマリ Azure SQL Database Server の名前。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |