Compartilhar via

New-AzSqlDatabaseFailoverGroup

  • Referência
Módulo:
Az.Sql

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

Sintaxe

New-AzSqlDatabaseFailoverGroup
   [-ServerName] <String>
   -FailoverGroupName <String>
   [-PartnerSubscriptionId <String>]
   [-PartnerResourceGroupName <String>]
   -PartnerServerName <String>
   [-FailoverPolicy <FailoverPolicy>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
   [-PartnerServerList <System.Collections.Generic.List`1[System.String]>]
   [-ReadOnlyEndpointTargetServer <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Cria um novo Grupo de Failover do Banco de Dados SQL do Azure dos servidores especificados. Dois pontos de extremidade TDS do Banco de Dados SQL do Azure são criados em FailoverGroupName.SqlDatabaseDnsSuffix (por exemplo, FailoverGroupName.database.windows.net) e FailoverGroupName.secondary.SqlDatabaseDnsSuffix. Esses pontos de extremidade podem ser usados para se conectar aos servidores primário e secundário no Grupo de Failover, respectivamente. Se o servidor primário for afetado por uma interrupção, o failover automático dos pontos de extremidade e bancos de dados será disparado conforme determinado pela política de failover e pelo período de carência do Grupo de Failover. Os Grupos de Failover recém-criados não contêm bancos de dados. Para controlar o conjunto de bancos de dados em um Grupo de Failover, use os cmdlets 'Add-AzSqlDatabaseToFailoverGroup' e 'Remove-AzSqlDatabaseFromFailoverGroup'. Somente valores maiores ou iguais a 1 hora têm suporte para o parâmetro '-GracePeriodWithDataLossHours'.

[! NOTE] É possível implantar seu grupo de failover automático em assinaturas usando o parâmetro -PartnerSubscriptionId no Azure Powershell a partir do Az.SQL 3.11.0.

Exemplos

Exemplo 1

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

Esse comando cria um novo Grupo de Failover com a política de failover 'Automática' para dois servidores no mesmo grupo de recursos.

Exemplo 2

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual

Esse comando cria um novo Grupo de Failover com a política de failover 'Manual' para dois servidores em grupos de recursos diferentes.

Exemplo 3

$sub2 = 'b3c40cd6-024f-428c-921b-cda6c6834c34'
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ServerName primaryserver -FailoverGroupName fg -PartnerSubscriptionId $sub2 -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverPolicy Manual -ResourceGroupName rg1

FailoverGroupName                    : fg
Location                             : East US
ResourceGroupName                    : rg1
ServerName                           : primaryserver
PartnerLocation                      : West US 2
PartnerResourceGroupName             : rg2
PartnerServerName                    : secondaryserver1
ReplicationRole                      : Primary
ReplicationState                     : CATCH_UP
ReadWriteFailoverPolicy              : Manual
FailoverWithDataLossGracePeriodHours :
DatabaseNames                        : {}

Esse comando cria um novo Grupo de Failover com a política de failover 'Manual' para dois servidores em assinaturas diferentes.

Parâmetros

-AllowReadOnlyFailoverToPrimary

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

Tipo:AllowReadOnlyFailoverToPrimary
Valores aceitos:Enabled, Disabled
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 usadas para 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

-FailoverGroupName

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

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

-FailoverPolicy

A política de failover do Grupo de Failover do Banco de Dados SQL do Azure.

Tipo:FailoverPolicy
Valores aceitos:Automatic, Manual
Cargo:Named
Valor padrão:Manual
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:1
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartnerResourceGroupName

O nome do grupo de recursos secundário do Grupo de Failover do Banco de Dados SQL do Azure.

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

-PartnerServerList

A lista de servidores parceiros no grupo de failover (lista vazia para 0 servidores).

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartnerServerName

O nome do servidor secundário do Grupo de Failover do Banco de Dados SQL do Azure.

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

-PartnerSubscriptionId

O nome da ID da assinatura secundária do Grupo de Failover do Banco de Dados SQL do Azure.

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

-ReadOnlyEndpointTargetServer

O nome do servidor de destino para o ponto de extremidade somente leitura. Se estiver vazio, o padrão será o valor de PartnerServerName.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
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:True
Aceitar caracteres curinga:False

-ServerName

O nome do servidor primário do Banco de Dados SQL do Azure do Grupo de Failover.

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

Entradas

String

Saídas

AzureSqlFailoverGroupModel