New-AzSqlDatabaseFailoverGroup

  • Referencia
Módulo:
Az.Sql

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

Syntax

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.

Type:AllowReadOnlyFailoverToPrimary
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-FailoverGroupName

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

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

-FailoverPolicy

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

Type:FailoverPolicy
Accepted values:Automatic, Manual
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PartnerResourceGroupName

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

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

-PartnerServerList

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServerName

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

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

-PartnerSubscriptionId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-ResourceGroupName

Nombre del grupo de recursos.

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

-ServerName

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

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

Entradas

String

Salidas

AzureSqlFailoverGroupModel