New-AzSqlDatabaseInstanceFailoverGroup

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

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

Crea un nuevo grupo de conmutación por error de instancia de Azure SQL Database entre las regiones especificadas con el par de Instancia administrada indicado.

Se crean dos puntos de conexión de TDS de Azure SQL Database en Name.SqlDatabaseDnsSuffix (por ejemplo, Name.database.windows.net) y Name.secondary.SqlDatabaseDnsSuffix. Estos puntos de conexión se pueden usar para conectarse a las regiones primarias y secundarias del grupo de conmutación por error, respectivamente. Si la región primaria se ve afectada por una interrupción, la conmutación automática por error de los puntos de conexión y las bases de datos se desencadenarán 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 de instancia.

Durante la versión preliminar de la característica Grupos de conmutación por error de instancia, solo se admiten valores mayores o iguales a 1 hora para el parámetro "-GracePeriodWithDataLossHours".

Ejemplos

Ejemplo 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 crea un nuevo grupo de conmutación por error de instancia con la directiva de conmutación por error "Automática" para el par Instancia administrada.

Ejemplo 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 crea un nuevo grupo de conmutación por error de instancia con la directiva de conmutación por error "Manual" para el par de Instancia administrada.

Ejemplo 3

Este comando crea un nuevo grupo de conmutación por error de instancia de Azure SQL Database. (generado automáticamente)

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

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados 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

-FailoverPolicy

Directiva de conmutación por error del grupo de conmutación por error de instancia.

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

-Location

Nombre de la región local desde la que se va a recuperar el grupo de conmutación por error de instancia.

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

-Name

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

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

-PartnerManagedInstanceName

Nombre del Instancia administrada de la región del asociado que se va a agregar al grupo de conmutación por error de instancia.

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

-PartnerRegion

Nombre de la región del asociado del grupo de conmutación por error de instancia.

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

-PartnerResourceGroupName

Nombre del grupo de recursos secundario del grupo de conmutación por error de instancia.

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

-PartnerSubscriptionId

Identificador de suscripción del Instancia administrada secundario del grupo de conmutación por error de instancia. Este parámetro solo es necesario para la configuración entre suscripciones.

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

-PrimaryManagedInstanceName

Nombre del Instancia administrada de la región local que se va a agregar al grupo de conmutación por error de instancia.

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

-SecondaryType

Uso previsto de la instancia secundaria. En espera indica que la instancia secundaria se usará como réplica pasiva solo para la recuperación ante desastres.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

String

Salidas

AzureSqlInstanceFailoverGroupModel