New-AzSqlDatabaseInstanceFailoverGroup

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

Syntax

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ância Gerenciada observado.

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 pontos de extremidade e bancos de dados será acionado conforme ditado 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 são suportados 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

Este comando cria um novo Grupo de Failover de Instância com 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

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

Exemplo 3

Este 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 failover automático do ponto de extremidade somente leitura.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailoverPolicy

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GracePeriodWithDataLossHours

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

O nome da Região Local da qual recuperar o Grupo de Failover de Instância.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartnerManagedInstanceName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartnerRegion

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartnerResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerSubscriptionId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryManagedInstanceName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

O nome do grupo de recursos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Saídas

AzureSqlInstanceFailoverGroupModel