Set-AzSqlDatabaseInstanceFailoverGroup

リファレンス

モジュール:: Az.Sql

インスタンスフェールオーバーグループの構成を変更します。

構文

Set-AzSqlDatabaseInstanceFailoverGroup
   [-ResourceGroupName] <String>
   [-Location] <String>
   [-Name] <String>
   [-FailoverPolicy <String>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <String>]
   [-SecondaryType <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSqlDatabaseInstanceFailoverGroup
   [-Location] <String>
   [-ResourceId] <String>
   [-FailoverPolicy <String>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <String>]
   [-SecondaryType <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSqlDatabaseInstanceFailoverGroup
   [-InputObject] <AzureSqlInstanceFailoverGroupModel>
   [-FailoverPolicy <String>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <String>]
   [-SecondaryType <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドは、インスタンスフェールオーバーグループの構成を変更します。

インスタンスフェールオーバーグループのプライマリリージョンを使用してコマンドを実行する必要があります。

インスタンスフェールオーバーグループ機能のプレビュー中、'-GracePeriodWithDataLossHours' パラメーターでは 1 時間以上の値のみがサポートされます。

例

例 1

$failoverGroup = Get-AzSqlDatabaseInstanceFailoverGroup -ResourceGroupName rg -Location location -Name fg | Set-AzSqlDatabaseInstanceFailoverGroup -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

フェールオーバーグループ内のパイプ処理によって、インスタンスフェールオーバーグループのフェールオーバーポリシーを "手動" に設定します。

パラメーター

-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

-InputObject

設定するインスタンスフェールオーバーグループオブジェクト

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

-Location

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

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

-Name

インスタンスフェールオーバーグループの名前。

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

-ResourceGroupName

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

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

-ResourceId

設定するインスタンスフェールオーバーグループのリソース ID。

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

-SecondaryType

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

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

-WhatIf

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

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

入力

AzureSqlInstanceFailoverGroupModel

System.String

出力