英語で読む

次の方法で共有

Start-AzSqlInstanceLinkFailover

  • リファレンス
モジュール:
Az.Sql

インスタンス リンクをフェールオーバーします。

構文

PowerShell 
Start-AzSqlInstanceLinkFailover
     [-ResourceGroupName] <String>
     [-InstanceName] <String>
     [-Name] <String>
     -FailoverType <String>
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
PowerShell 
Start-AzSqlInstanceLinkFailover
     [-Name] <String>
     -FailoverType <String>
     [-InstanceObject] <AzureSqlManagedInstanceModel>
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
PowerShell 
Start-AzSqlInstanceLinkFailover
     [-Name] <String>
     -FailoverType <String>
     [-InputObject] <AzureSqlManagedInstanceLinkModel>
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
PowerShell 
Start-AzSqlInstanceLinkFailover
     -FailoverType <String>
     [-ResourceId] <String>
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-AzSqlInstanceLinkFailover コマンドレット インスタンス リンクをフェールオーバーします。

例

例 1

PowerShell 
Start-AzSqlInstanceLinkFailover -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" -Name "Link01" -FailoverType "ForcedAllowDataLoss"

ResourceGroupName                : ResourceGroup01
InstanceName                     : ManagedInstance01
Type                             : Microsoft.Sql/managedInstances/distributedAvailabilityGroups
Id                               : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/managedInstances/ManagedInstance01/distributedAvailabilityGroups/Link01
Name                             : Link01
DistributedAvailabilityGroupName : Link01
DistributedAvailabilityGroupId   : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Databases                        : {Database01}
InstanceAvailabilityGroupName    : AG_Database01_MI
PartnerAvailabilityGroupName     : AG_Database01
PartnerEndpoint                  : TCP://SERVER01:5022
InstanceLinkRole                 : Primary
PartnerLinkRole                  : Secondary
ReplicationMode                  : Async
FailoverMode                     : Manual
SeedingMode                      : Automatic

このコマンドは、"Link01" という名前のインスタンス リンクの強制フェールオーバーを実行します。

例 2

PowerShell 
$instance = Get-AzSqlInstance -ResourceGroupName "ResourceGroup01" -Name "ManagedInstance01"
$instance | Start-AzSqlInstanceLinkFailover -Name "Link01" -FailoverType "Planned"

ResourceGroupName                : ResourceGroup01
InstanceName                     : ManagedInstance01
Type                             : Microsoft.Sql/managedInstances/distributedAvailabilityGroups
Id                               : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/managedInstances/ManagedInstance01/distributedAvailabilityGroups/Link01
Name                             : Link01
DistributedAvailabilityGroupName : Link01
DistributedAvailabilityGroupId   : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Databases                        : {Database01}
InstanceAvailabilityGroupName    : AG_Database01_MI
PartnerAvailabilityGroupName     : AG_Database01
PartnerEndpoint                  : TCP://SERVER01:5022
InstanceLinkRole                 : Primary
PartnerLinkRole                  : Secondary
ReplicationMode                  : Async
FailoverMode                     : Manual
SeedingMode                      : Automatic

このコマンドは、インスタンス オブジェクトをパイプ処理することで、インスタンス リンクの計画的なフェールオーバーを実行します。

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-FailoverType

フェールオーバーの種類は、ForcedAllowDataLoss または Planned です。

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

-Force

アクションを実行するための確認メッセージをスキップする

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

-InputObject

インスタンス リンク入力オブジェクト。

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

-InstanceName

マネージド インスタンスの名前。

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

-InstanceObject

インスタンス入力オブジェクト。

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

-Name

Managed Instance のリンク名。

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

-ResourceGroupName

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

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

-ResourceId

インスタンス リンク リソース ID。

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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

入力

出力