Compartilhar via


New-AzSqlDatabaseInstanceFailoverGroup

Esse comando cria um novo Grupo de Failover de Instância do Banco de Dados SQL do Azure.

Sintaxe

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>]

Description

Cria um novo Grupo de Failover de Instância do Banco de Dados SQL do Azure entre as regiões especificadas com o par de Instâncias Gerenciadas anotado.

Dois pontos de extremidade TDS do Banco de Dados SQL do Azure são criados em Name.SqlDatabaseDnsSuffix (por exemplo, Name.database.windows.net) e Name.secondary.SqlDatabaseDnsSuffix. Esses pontos de extremidade podem ser usados para se conectar às regiões primária e secundária do Grupo de Failover, respectivamente. Se a região primária for afetada por uma interrupção, o failover automático dos endpoints e bancos de dados será disparado conforme determinado pela política de failover e pelo período de carência do Grupo de Failover de Instância.

Durante a visualização do recurso Grupos de Failover de Instância, somente valores maiores ou iguais a 1 hora têm suporte para o parâmetro '-GracePeriodWithDataLossHours'.

Exemplos

Exemplo 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

Esse comando cria um novo Grupo de Failover de Instância com a política de failover 'Automática' para o par de Instâncias Gerenciadas.

Exemplo 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

Esse comando cria um novo Grupo de Failover de Instância com a política de failover 'Manual' para o par de Instâncias Gerenciadas.

Exemplo 3

Esse comando cria um novo Grupo de Failover de Instância do Banco de Dados SQL do Azure. (gerado automaticamente)

New-AzSqlDatabaseInstanceFailoverGroup -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1 -Location location -Name fgName -PartnerManagedInstanceName $partnerManagedInstance.Name -PartnerRegion $partnerRegion -PartnerResourceGroupName rg2 -PrimaryManagedInstanceName $managedInstance.Name -ResourceGroupName rg

Parâmetros

-AllowReadOnlyFailoverToPrimary

Se uma interrupção no servidor secundário deve disparar o failover automático do ponto de extremidade somente leitura.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FailoverPolicy

A política de failover do Grupo de Failover de Instância.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GracePeriodWithDataLossHours

Intervalo antes do início do failover automático se ocorrer uma interrupção no servidor primário e o failover não puder ser concluído sem perda de dados.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

O nome da região local da qual recuperar o grupo de failover de instância.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome do Grupo de Failover do Banco de Dados SQL do Azure a ser criado.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartnerManagedInstanceName

O nome da Instância Gerenciada na região do parceiro a ser adicionada ao Grupo de Failover de Instância.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartnerRegion

O nome da região do parceiro do Grupo de Failover de Instância.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartnerResourceGroupName

O nome do grupo de recursos secundário do Grupo de Failover de Instância.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartnerSubscriptionId

A ID da assinatura da Instância Gerenciada secundária do Grupo de Failover de Instância. Esse parâmetro só é necessário para a configuração entre assinaturas

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrimaryManagedInstanceName

O nome da Instância Gerenciada na região local a ser adicionada ao Grupo de Failover de Instância.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecondaryType

Uso pretendido da instância secundária. Em espera indica que a instância secundária será usada como uma réplica passiva somente para recuperação de desastres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

AzureSqlInstanceFailoverGroupModel