Partilhar via


New-AzSqlDatabaseFailoverGroup

Este comando cria um novo Base de Dados SQL do Azure Failover Group.

Sintaxe

Default (Predefinição)

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 Base de Dados SQL do Azure Failover Group para os servidores especificados. São criados dois Base de Dados SQL do Azure endpoints TDS 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á acionado conforme ditado 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 são suportados para o parâmetro '-GracePeriodWithDataLossHours'.

[! NOTA] É possível implementar o seu grupo de auto-failover entre subscrições usando o parâmetro -PartnerSubscriptionId no Azure Powershell a partir de Az.SQL 3.11.0.

Exemplos

Exemplo 1

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

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

Este comando cria um novo Grupo de Failover com 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                        : {}

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

Parâmetros

-AllowReadOnlyFailoverToPrimary

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

Propriedades dos parâmetros

Tipo:AllowReadOnlyFailoverToPrimary
Default value:None
Valores aceites:Enabled, Disabled
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FailoverGroupName

O nome do Base de Dados SQL do Azure Failover Group a criar.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FailoverPolicy

A política de failover do Base de Dados SQL do Azure Failover Group.

Propriedades dos parâmetros

Tipo:FailoverPolicy
Default value:Manual
Valores aceites:Automatic, Manual
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Int32
Default value:1
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PartnerResourceGroupName

O nome do grupo de recursos secundário do Base de Dados SQL do Azure Failover Group.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PartnerServerList

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

Propriedades dos parâmetros

Tipo:

List<T>[String]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PartnerServerName

O nome do servidor secundário do Base de Dados SQL do Azure Failover Group.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PartnerSubscriptionId

O nome do ID de subscrição secundário do Base de Dados SQL do Azure Failover Group.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

O nome do grupo de recursos.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ServerName

O nome do principal Base de Dados SQL do Azure Server do Grupo de Failover.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

AzureSqlFailoverGroupModel