New-AzSqlDatabaseInstanceFailoverGroup

Référence

Module:: Az.Sql

Cette commande crée un groupe de basculement d’instance Azure SQL Database.

Syntaxe

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

Crée un groupe de basculement d’instance Azure SQL Database entre les régions spécifiées avec la paire Managed Instance notée.

Deux points de terminaison TDS Azure SQL Database sont créés sur Name.SqlDatabaseDnsSuffix (par exemple, Name.database.windows.net) et Name.secondary.SqlDatabaseDnsSuffix. Ces points de terminaison peuvent être utilisés pour se connecter aux régions primaires et secondaires du groupe de basculement, respectivement. Si la région primaire est affectée par une panne, le basculement automatique des points de terminaison et des bases de données est déclenché comme indiqué par la stratégie de basculement du groupe de basculement d’instance et la période de grâce.

Pendant la préversion de la fonctionnalité Groupes de basculement d’instance, seules les valeurs supérieures ou égales à 1 heure sont prises en charge pour le paramètre « -GracePeriodWithDataLossHours ».

Exemples

Exemple 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

Cette commande crée un groupe de basculement d’instance avec la stratégie de basculement « Automatique » pour la paire Managed Instance.

Exemple 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

Cette commande crée un groupe de basculement d’instance avec la stratégie de basculement « Manuel » pour la paire Managed Instance.

Exemple 3

Cette commande crée un groupe de basculement d’instance Azure SQL Database. (généré automatiquement)

New-AzSqlDatabaseInstanceFailoverGroup -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1 -Location location -Name fgName -PartnerManagedInstanceName $partnerManagedInstance.Name -PartnerRegion $partnerRegion -PartnerResourceGroupName rg2 -PrimaryManagedInstanceName $managedInstance.Name -ResourceGroupName rg

Paramètres

-AllowReadOnlyFailoverToPrimary

Indique si une panne sur le serveur secondaire doit déclencher un basculement automatique du point de terminaison en lecture seule.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-FailoverPolicy

Stratégie de basculement du groupe de basculement d’instance.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-GracePeriodWithDataLossHours

Intervalle avant le lancement du basculement automatique si une panne se produit sur le serveur principal et que le basculement ne peut pas être terminé sans perte de données.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Location

Nom de la région locale à partir de laquelle récupérer le groupe de basculement d’instance.

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Nom du groupe de basculement Azure SQL Database à créer.

Type:	String
Position:	2
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartnerManagedInstanceName

Nom de l’instance managée dans la région partenaire à ajouter au groupe de basculement d’instance.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartnerRegion

Nom de la région partenaire du groupe de basculement d’instance.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartnerResourceGroupName

Nom du groupe de ressources secondaire du groupe de basculement d’instance.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartnerSubscriptionId

ID d’abonnement de l’instance managée secondaire du groupe de basculement d’instance. Ce paramètre n’est nécessaire que pour la configuration entre abonnements

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PrimaryManagedInstanceName

Nom de l’instance managée dans la région locale à ajouter au groupe de basculement d’instance.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SecondaryType

Utilisation prévue de l’instance secondaire. La veille indique que l’instance secondaire sera utilisée en tant que réplica passif uniquement pour la récupération d’urgence.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

Sorties

AzureSqlInstanceFailoverGroupModel

Partager via