New-SqlAvailabilityGroup

Module:

SQLPS Module

Crée un groupe de disponibilité.

Syntaxe

ByPath (Par défaut)

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande New-SqlAvailabilityGroup crée un groupe de disponibilité dans les groupes de disponibilité AlwaysOn. Le paramètre InputObject ou Path spécifie le serveur qui héberge le réplica principal initial.

Exemples

Exemple 1 : Créer un groupe de disponibilité

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

La première commande obtient une instance de SQL Server sur le serveur principal, puis la stocke dans la variable $PrimaryServer.

La deuxième commande obtient une instance de SQL Server sur le serveur secondaire, puis la stocke dans la variable $SecondaryServer.

La troisième commande crée un réplica qui inclut l’instance de serveur principal à l’aide de l’applet de commande New-SqlAvailabilityReplica , puis la stocke dans la variable $PrimaryReplica. La commande spécifie la version de l’instance de serveur à l’aide de la propriété Version de $PrimaryServer.

La quatrième commande crée un réplica qui inclut l’instance de serveur secondaire à l’aide de New-SqlAvailabilityReplica, puis la stocke dans la variable $SecondaryReplica. La commande spécifie la version de l’instance de serveur à l’aide de la propriété Version de $SecondaryServer.

La commande finale crée le groupe de disponibilité. Il spécifie le nom, le serveur principal, les réplicas et d’autres informations.

Paramètres

-AutomatedBackupPreference

Spécifie la préférence de sauvegarde automatisée pour le groupe de disponibilité. Les valeurs acceptables pour ce paramètre sont les suivantes :

• Primaire. Spécifie que les sauvegardes se produisent toujours sur le réplica principal. Cette option prend en charge l’utilisation de fonctionnalités non disponibles lorsque la sauvegarde s’exécute sur un réplica secondaire, comme les sauvegardes différentielles.
• SecondaryOnly. Spécifie que les sauvegardes ne sont jamais effectuées sur les réplicas principaux. Si le réplica principal est le seul réplica en ligne, la sauvegarde ne se produit pas.
• Secondaire. Spécifie que les sauvegardes se produisent sur des réplicas secondaires, sauf si le réplica principal est le seul réplica en ligne. Ensuite, la sauvegarde se produit sur le réplica principal.
• Aucun. Spécifie que l’état principal ou secondaire n’est pas pris en compte lors du choix du réplica qui effectue des sauvegardes. Au lieu de cela, la priorité de sauvegarde et l’état en ligne déterminent quel réplica effectue des sauvegardes.

Propriétés du paramètre

Type:	AvailabilityGroupAutomatedBackupPreference
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

-AvailabilityReplica

Spécifie un tableau de réplicas de disponibilité que cette applet de commande inclut dans le groupe de disponibilité. Pour obtenir un objet AvailabilityReplica , utilisez l’applet de commande New-SqlAvailabilityReplica . Spécifiez le paramètre AsTemplate .

Propriétés du paramètre

Type:	AvailabilityReplica[]
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

-BasicAvailabilityGroup

L’applet de commande New-SqlAvailabilityGroup crée un groupe de disponibilité dans les groupes de disponibilité AlwaysOn. Le paramètre InputObject ou Path spécifie le serveur qui héberge le réplica principal initial.

Propriétés du paramètre

Type:	SwitchParameter
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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

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

-Database

Spécifie un tableau de bases de données utilisateur locales en lecture/écriture. Ces bases de données doivent utiliser le modèle de récupération complète et ne doivent pas utiliser AUTO_CLOSE. Ces bases de données ne peuvent pas appartenir à un autre groupe de disponibilité et ne peuvent pas être configurées pour la mise en miroir de bases de données. Vous devez spécifier une valeur pour ce paramètre.

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

-DatabaseHealthTrigger

L’applet de commande New-SqlAvailabilityGroup crée un groupe de disponibilité dans les groupes de disponibilité AlwaysOn. Le paramètre InputObject ou Path spécifie le serveur qui héberge le réplica principal initial.

Propriétés du paramètre

Type:	SwitchParameter
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

-DtcSupportEnabled

L’applet de commande New-SqlAvailabilityGroup crée un groupe de disponibilité dans les groupes de disponibilité AlwaysOn. Le paramètre InputObject ou Path spécifie le serveur qui héberge le réplica principal initial.

Propriétés du paramètre

Type:	SwitchParameter
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

-FailureConditionLevel

Spécifie le comportement de basculement automatique du groupe de disponibilité. Les valeurs acceptables pour ce paramètre sont les suivantes :

• OnServerDown. Basculement ou redémarrage si le service SQL Server s’arrête.
• OnServerUnresponsive. Basculement ou redémarrage si une condition de valeur inférieure est satisfaite, ainsi que lorsque le service SQL Server est connecté au cluster et que le seuil HealthCheckTimeout est dépassé ou si le réplica de disponibilité actuellement en rôle principal est dans un état d’échec.
• OnCriticalServerError. Basculement ou redémarrage si une condition de valeur inférieure est satisfaite, plus lorsqu’une erreur de serveur critique interne se produit, qui inclut une condition de mémoire insuffisante, une violation grave d’accès en écriture ou trop de vidage.
• OnModerateServerError. Basculement ou redémarrage si une condition de valeur inférieure est satisfaite, plus si une erreur serveur modérée se produit, ce qui inclut une condition persistante de mémoire insuffisante.
• OnAnyQualifiedFailureConditions. Basculement ou redémarrage si une condition de valeur inférieure est satisfaite, plus si une condition d’échec éligible se produit, ce qui inclut l’épuisement des threads de travail du moteur et un blocage irrésolvable détecté.

Propriétés du paramètre

Type:	AvailabilityGroupFailureConditionLevel
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

-HealthCheckTimeout

Spécifie la durée, en millisecondes, après laquelle les groupes de disponibilité AlwaysOn déclarent un serveur non répondif pour qu’il soit défectueux.

Propriétés du paramètre

Type:	Int32
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

-InputObject

Spécifie l’instance de SQL Server qui héberge le réplica principal du groupe de disponibilité créé par cette applet de commande.

Propriétés du paramètre

Type:	Server
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ByObject

Position:	3
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Spécifie le nom du groupe de disponibilité créé par cette applet de commande.

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:	2
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Path

Spécifie le chemin d’accès de l’instance de SQL Server qui héberge le réplica principal initial du groupe de disponibilité créé par cette applet de commande. Si vous ne spécifiez pas ce paramètre, cette applet de commande utilise l’emplacement de travail actuel. Si vous spécifiez une valeur, le chemin d’accès doit exister actuellement.

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

ByPath

Position:	3
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Script

Indique que cette applet de commande retourne un script Transact-SQL qui effectue la tâche effectuée par cette applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

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

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.

Entrées

Microsoft.SqlServer.Management.Smo.Server

Vous pouvez transmettre une instance de serveur à cette applet de commande.

Sorties

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Cette applet de commande retourne un groupe de disponibilité.

Liens associés

• Join-SqlAvailabilityGroup
• New-SqlAvailabilityReplica
• Remove-SqlAvailabilityGroup
• Set-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup