Partager via

Set-SqlAvailabilityGroup

Module:
SQLPS Module

Définit les paramètres d’un groupe de disponibilité.

Syntaxe

ByPath (Par défaut) 

Set-SqlAvailabilityGroup
    [[-Path] <String>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

Set-SqlAvailabilityGroup
    [-InputObject] <AvailabilityGroup>
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Set-SqlAvailabilityGroup modifie les paramètres d’un groupe de disponibilité existant dans les groupes de disponibilité AlwaysOn. Vous pouvez modifier la préférence de sauvegarde automatisée, le niveau de condition d’échec et le délai d’expiration du contrôle d’intégrité. Vous devez exécuter cette applet de commande sur l’instance de serveur qui héberge le réplica principal.

Exemples

Exemple 1 : Modifier la période d’expiration du contrôle d’intégrité

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000

Cette commande modifie la propriété de délai d’expiration du contrôle d’intégrité sur le groupe de disponibilité nommé MainAG à 120 000 millisecondes, ou deux minutes. Si le basculement automatique est activé, après cette durée, les groupes de disponibilité AlwaysOn lancent un basculement automatique.

Exemple 2 : Modifier la préférence de sauvegarde automatisée

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -AutomatedBackupPreference SecondaryOnly

Cette commande modifie la préférence de sauvegarde automatisée sur le groupe de disponibilité nommé MainAG comme SecondaryOnly. Les sauvegardes automatisées des bases de données dans ce groupe de disponibilité ne se produisent pas sur le réplica principal. Au lieu de cela, les sauvegardes automatisées se produisent sur le réplica secondaire qui a la priorité de sauvegarde la plus élevée.

Exemple 3 : Modifier le niveau de condition d’échec

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -FailureConditionLevel OnServerDown

Cette commande modifie le niveau de condition d’échec du groupe de disponibilité nommé MainAG comme OnServerDown. Si l’instance de serveur qui héberge le réplica principal est hors connexion et si le basculement automatique est activé, les groupes de disponibilité AlwaysOn démarrent un basculement automatique.

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

-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

-DatabaseHealthTrigger

L’applet de commande Set-SqlAvailabilityGroup modifie les paramètres d’un groupe de disponibilité existant dans les groupes de disponibilité AlwaysOn. Vous pouvez modifier la préférence de sauvegarde automatisée, le niveau de condition d’échec et le délai d’expiration du contrôle d’intégrité. Vous devez exécuter cette applet de commande sur l’instance de serveur qui héberge le réplica principal.

Propriétés du paramètre

Type:Boolean
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 de serveur modérée se produit, ce qui inclut une condition de mémoire insuffisante persistante.
  • 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 qu’un serveur non répond comme non sain.

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 le groupe de disponibilité, en tant qu’objet AvailabilityGroup , que cette applet de commande modifie.

Propriétés du paramètre

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

Jeux de paramètres

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

-Path

Spécifie le chemin d’accès de la base de données de disponibilité que l’applet de commande modifie. Si vous ne spécifiez pas ce paramètre, cette applet de commande utilise l’emplacement de travail actuel.

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:2
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.