Compartir a través de

New-AzSqlDatabaseFailoverGroup

  • Referencia
Módulo:
Az.Sql

Este comando crea un nuevo grupo de conmutación por error de Azure SQL Database.

Sintaxis

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

Crea un nuevo grupo de conmutación por error de Azure SQL Database para los servidores especificados. Se crean dos puntos de conexión de TDS de Azure SQL Database en FailoverGroupName.SqlDatabaseDnsSuffix (por ejemplo, FailoverGroupName.database.windows.net) y FailoverGroupName.secondary.SqlDatabaseDnsSuffix. Estos puntos de conexión se pueden usar para conectarse a los servidores principales y secundarios del grupo de conmutación por error, respectivamente. Si el servidor principal se ve afectado por una interrupción, la conmutación automática por error de los puntos de conexión y las bases de datos se desencadenará según lo dictado por la directiva de conmutación por error y el período de gracia del grupo de conmutación por error. Los grupos de conmutación por error recién creados no contienen ninguna base de datos. Para controlar el conjunto de bases de datos en un grupo de conmutación por error, use los cmdlets "Add-AzSqlDatabaseToFailoverGroup" y "Remove-AzSqlDatabaseFromFailoverGroup". Solo se admiten valores mayores o iguales a 1 hora para el parámetro "-GracePeriodWithDataLossHours".

[! NOTA] Es posible implementar el grupo de conmutación por error automática entre suscripciones mediante el parámetro -PartnerSubscriptionId en Azure PowerShell a partir de Az.SQL 3.11.0.

Ejemplos

Ejemplo 1

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

Este comando crea un nuevo grupo de conmutación por error con la directiva de conmutación por error "Automática" para dos servidores del mismo grupo de recursos.

Ejemplo 2

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

Este comando crea un nuevo grupo de conmutación por error con la directiva de conmutación por error "Manual" para dos servidores en distintos grupos de recursos.

Ejemplo 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 crea un nuevo grupo de conmutación por error con la directiva de conmutación por error "Manual" para dos servidores en suscripciones diferentes.

Parámetros

-AllowReadOnlyFailoverToPrimary

Si una interrupción en el servidor secundario debe desencadenar la conmutación automática por error del punto de conexión de solo lectura.

Tipo:AllowReadOnlyFailoverToPrimary
Valores aceptados:Enabled, Disabled
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FailoverGroupName

Nombre del grupo de conmutación por error de Azure SQL Database que se va a crear.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FailoverPolicy

Directiva de conmutación por error del grupo de conmutación por error de Azure SQL Database.

Tipo:FailoverPolicy
Valores aceptados:Automatic, Manual
Posición:Named
Valor predeterminado:Manual
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GracePeriodWithDataLossHours

Intervalo antes de iniciar la conmutación automática por error si se produce una interrupción en el servidor principal y no se puede completar la conmutación por error sin pérdida de datos.

Tipo:Int32
Posición:Named
Valor predeterminado:1
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerResourceGroupName

Nombre del grupo de recursos secundario del grupo de conmutación por error de Azure SQL Database.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerServerList

La lista de servidores asociados del grupo de conmutación por error (lista vacía para 0 servidores).

Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerServerName

Nombre del servidor secundario del grupo de conmutación por error de Azure SQL Database.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerSubscriptionId

Nombre del identificador de suscripción secundario del grupo de conmutación por error de Azure SQL Database.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ReadOnlyEndpointTargetServer

Nombre del servidor de destino para el punto de conexión de solo lectura. Si está vacío, el valor predeterminado es PartnerServerName.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServerName

Nombre del servidor principal de Azure SQL Database del grupo de conmutación por error.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

Salidas

AzureSqlFailoverGroupModel