New-AzureRmSqlDatabaseFailoverGroup

  • Référence
Module:
AzureRM.Sql

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

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

New-AzureRmSqlDatabaseFailoverGroup
   [-ServerName] <String>
   -FailoverGroupName <String>
   [-PartnerResourceGroupName <String>]
   -PartnerServerName <String>
   [-FailoverPolicy <FailoverPolicy>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
   [-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-AzureRmSqlDatabaseToFailoverGroup » et « Remove-AzureRmSqlDatabaseFromFailoverGroup ». Pendant la préversion de la fonctionnalité Groupes de basculement, seules les valeurs supérieures ou égales à 1 heure sont prises en charge pour le paramètre « -GracePeriodWithDataLossHours ».

Exemples

Exemple 1

C:\> $failoverGroup = New-AzureRMSqlDatabaseFailoverGroup -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

C:\> $failoverGroup = New-AzureRMSqlDatabaseFailoverGroup -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.

Paramètres

-AllowReadOnlyFailoverToPrimary

Indique si une panne sur le serveur secondaire doit déclencher un basculement automatique du point de terminaison en lecture seule. Cette fonctionnalité n’est pas encore prise en charge.

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

-DefaultProfile

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

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

-FailoverGroupName

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

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

-FailoverPolicy

Stratégie de basculement du groupe de basculement 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

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
Default value:1
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerResourceGroupName

Nom du groupe de ressources secondaire du groupe de basculement Azure SQL Database.

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

-PartnerServerName

Nom du serveur secondaire du groupe de basculement Azure SQL Database.

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

-ResourceGroupName

Nom du groupe de ressources.

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

-ServerName

Nom du serveur Azure SQL Database principal du groupe de basculement.

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

Entrées

String

Sorties

AzureSqlFailoverGroupModel