New-AzSqlDatabaseFailoverGroup
Cette commande crée un groupe de basculement Azure SQL Database.
Syntaxe
Default (Par défaut)
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
Crée un groupe de basculement Azure SQL Database pour les serveurs spécifiés.
Deux points de terminaison TDS Azure SQL Database sont créés sur FailoverGroupName.SqlDatabaseDnsSuffix (par exemple, FailoverGroupName.database.windows.net) et FailoverGroupName.secondary.SqlDatabaseDnsSuffix. Ces points de terminaison peuvent être utilisés pour se connecter aux serveurs principaux et secondaires du groupe de basculement, respectivement. Si le serveur principal est affecté 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 et la période de grâce du groupe de basculement.
Les groupes de basculement nouvellement créés ne contiennent aucune base de données. Pour contrôler l’ensemble de bases de données dans un groupe de basculement, utilisez les applets de commande « Add-AzSqlDatabaseToFailoverGroup » et « Remove-AzSqlDatabaseFromFailoverGroup ».
Seules les valeurs supérieures ou égales à 1 heure sont prises en charge pour le paramètre « -GracePeriodWithDataLossHours ».
[! REMARQUE] Il est possible de déployer votre groupe de basculement automatique entre les abonnements à l’aide du paramètre -PartnerSubscriptionId dans Azure PowerShell à partir de Az.SQL 3.11.0 .
Exemples
Exemple 1
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1
Cette commande crée un groupe de basculement avec la stratégie de basculement « Automatique » pour deux serveurs du même groupe de ressources.
Exemple 2
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual
Cette commande crée un groupe de basculement avec la stratégie de basculement « Manuel » pour deux serveurs dans différents groupes de ressources.
Exemple 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 : {}
Cette commande crée un groupe de basculement avec la stratégie de basculement « Manuel » pour deux serveurs dans des abonnements différents.
Paramètres
-AllowReadOnlyFailoverToPrimary
Indique si une panne sur le serveur secondaire doit déclencher un basculement automatique du point de terminaison en lecture seule.
Propriétés du paramètre
Type: AllowReadOnlyFailoverToPrimary
Valeur par défaut: None Valeurs acceptées: Enabled, Disabled Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-FailoverGroupName
Nom du groupe de basculement Azure SQL Database à créer.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-FailoverPolicy
Stratégie de basculement du groupe de basculement Azure SQL Database.
Propriétés du paramètre
Type: FailoverPolicy
Valeur par défaut: Manual Valeurs acceptées: Automatic, Manual Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: 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.
Propriétés du paramètre
Type: Int32
Valeur par défaut: 1 Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-PartnerResourceGroupName
Nom du groupe de ressources secondaire du groupe de basculement Azure SQL Database.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-PartnerServerList
Liste des serveurs partenaires dans le groupe de basculement (liste vide pour 0 serveurs).
Propriétés du paramètre
Type: List<T> [ String ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-PartnerServerName
Nom du serveur secondaire du groupe de basculement Azure SQL Database.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-PartnerSubscriptionId
Nom de l’ID d’abonnement secondaire du groupe de basculement Azure SQL Database.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ReadOnlyEndpointTargetServer
Nom du serveur cible pour le point de terminaison en lecture seule. S’il est vide, la valeur par défaut de PartnerServerName est définie.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ResourceGroupName
Nom du groupe de ressources.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 0 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-ServerName
Nom du serveur Azure SQL Database principal du groupe de basculement.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 1 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
