Vue d’ensemble des applets de commande PowerShell pour les groupes de disponibilité Always On

S’applique à :SQL Server

Microsoft PowerShell est un interpréteur de ligne de commande et un langage de script basé sur des tâches tout spécialement conçu pour l’administration système. Groupes de disponibilité Always On fournit un ensemble d'applets de commande PowerShell dans SQL Server qui vous permet de déployer, gérer et surveiller des groupes de disponibilité, des réplicas de disponibilité et des bases de données de disponibilité.

Notes

Une applet de commande PowerShell peut s'effectuer en initiant correctement une action. Cela n'indique pas si le travail prévu, tel que le basculement d'un groupe de disponibilité, est terminé. Lors de l'écriture sous forme de script d'une séquence d'actions, vous devrez peut-être vérifier l'état des actions et attendre la fin de leur exécution.

Notes

Pour obtenir la liste des rubriques de la documentation en ligne SQL Server qui expliquent comment utiliser les applets de commande pour effectuer des tâches Groupes de disponibilité Always On , consultez la section « Tâches associées » de l’article Vue d’ensemble des groupes de disponibilité Always On (SQL Server).

Configuration d’une instance de serveur pour les groupes de disponibilité Always On

Applets de commande	Description	Prise en charge sur
Disable-SqlAlwaysOn	Désactive la fonctionnalité Groupes de disponibilité Always On sur une instance de serveur.	Instance de serveur spécifiée par le paramètre Path, InputObjectou Name . (Il doit s'agir d'une édition de SQL Server qui prend en charge Groupes de disponibilité Always On.)
Enable-SqlAlwaysOn	Active Groupes de disponibilité Always On sur une instance de SQL Server qui prend en charge la fonctionnalité Groupes de disponibilité Always On . Pour plus d’informations sur la prise en charge des groupes de disponibilité Always On, consultez Conditions préalables requises, restrictions et recommandations pour les groupes de disponibilité Always On (SQL Server).	Toute édition de SQL Server qui prend en charge Groupes de disponibilité Always On.
New-SqlHadrEndPoint	Crée un nouveau point de terminaison de mise en miroir de bases de données sur une instance de serveur. Ce point de terminaison est requis pour le déplacement des données entre des bases de données primaires et secondaires.	Toute instance de SQL Server
Set-SqlHadrEndpoint	Modifie les propriétés d'un point de terminaison de mise en miroir de bases de données existant, telles que le nom, l'état ou les propriétés d'authentification.	Instance de serveur qui prend en charge Groupes de disponibilité Always On et ne dispose pas d'un point de terminaison de mise en miroir de bases de données

Sauvegarde et restauration de bases de données et de journaux de transactions

Applets de commande	Description	Prise en charge sur
Backup-SqlDatabase	Crée une sauvegarde de données ou de journal.	Base de données en ligne (pour Groupes de disponibilité Always On, base de données sur l'instance de serveur qui héberge le réplica principal)
Restore-SqlDatabase	Restaure une sauvegarde.	Instance de SQL Server (pour Groupes de disponibilité Always On, instance de serveur qui héberge un réplica secondaire)

Important

Quand vous préparez une base de données secondaire, vous devez utiliser le paramètre -NoRecovery dans chaque commande Restore-SqlDatabase.

Pour plus d’informations sur l’utilisation de ces applets de commande pour préparer une base de données secondaire, consultez Préparer manuellement une base de données secondaire pour un groupe de disponibilité (SQL Server).

Création et gestion d'un groupe de disponibilité

Applets de commande	Description	Prise en charge sur
New-SqlAvailabilityGroup	Crée un groupe de disponibilité.	Instance de serveur pour héberger le réplica principal
Remove-SqlAvailabilityGroup	Supprime un groupe de disponibilité	Instance de serveur activée pour le service HADR
Set-SqlAvailabilityGroup	Définit les propriétés d'un groupe de disponibilité ; met un groupe de disponibilité en ligne/hors connexion	Instance de serveur qui héberge le réplica principal
Switch-SqlAvailabilityGroup	Démarre l'une des formes de basculement suivantes : Basculement forcé d'un groupe de disponibilité (avec possible perte de données). Basculement manuel d'un groupe de disponibilité.	Instance de serveur qui héberge le réplica secondaire cible.

Création et gestion d'un écouteur de groupe de disponibilité

Applet de commande	Description	Prise en charge sur
New-SqlAvailabilityGroupListener	Crée un écouteur de groupe de disponibilité et l'attache à un groupe de disponibilité existant.	Instance de serveur qui héberge le réplica principal
Set-SqlAvailabilityGroupListener	Modifie le paramètre de port sur un écouteur de groupe de disponibilité existant.	Instance de serveur qui héberge le réplica principal
Add-SqlAvailabilityGroupListenerStaticIp	Ajoute une adresse IP statique à une configuration existante d'écouteur de groupe de disponibilité. L'adresse IP peut être une adresse IPv4 avec sous-réseau ou une adresse IPv6.	Instance de serveur qui héberge le réplica principal

Création et gestion d'un réplica de disponibilité

Applets de commande	Description	Prise en charge sur
New-SqlAvailabilityReplica	Crée un réplica de disponibilité. Vous pouvez utiliser le paramètre -AsTemplate pour créer un objet en mémoire du réplica de disponibilité pour chaque nouveau réplica de disponibilité.	Instance de serveur qui héberge le réplica principal
Join-SqlAvailabilityGroup	Joint un réplica secondaire au groupe de disponibilité.	Instance de serveur qui héberge le réplica secondaire.
Remove-SqlAvailabilityReplica	Supprime un réplica de disponibilité.	Instance de serveur qui héberge le réplica principal
Set-SqlAvailabilityReplica	Définit les propriétés d'un réplica de disponibilité.	Instance de serveur qui héberge le réplica principal

Ajout et gestion d'une base de données de disponibilité

Applets de commande	Description	Prise en charge sur
Add-SqlAvailabilityDatabase	Sur le réplica principal, ajoute une base de données à un groupe de disponibilité. Sur un réplica secondaire, joint une base de données secondaire à un groupe de disponibilité.	Instance de serveur qui héberge un réplica de disponibilité (le comportement diffère pour les réplicas principal et secondaire)
Remove-SqlAvailabilityDatabase	Sur le réplica principal, supprime la base de données du groupe de disponibilité. Sur un réplica secondaire, supprime la base de données secondaire locale du réplica secondaire local.	Instance de serveur qui héberge un réplica de disponibilité (le comportement diffère pour les réplicas principal et secondaire)
Resume-SqlAvailabilityDatabase	Reprend le déplacement des données pour une base de données de disponibilité interrompue.	Instance de serveur sur laquelle la base de données a été interrompue.
Suspend-SqlAvailabilityDatabase	Interrompt le déplacement des données pour une base de données de disponibilité.	Instance de serveur qui héberge un réplica de disponibilité.

Surveillance de l'intégrité d'un groupe de disponibilité

Les applets de commande SQL Server suivantes vous permettent de surveiller l'intégrité d'un groupe de disponibilité et de ses réplicas et bases de données.

Important

Vous devez disposer des autorisations CONNECT, VIEW SERVER STATE et VIEW ANY DEFINITION pour exécuter ces applets de commande.

Applet de commande	Description	Prise en charge sur
Test-SqlAvailabilityGroup	Évalue l'intégrité d'un groupe de disponibilité lors de l'évaluation des stratégies de gestion basées sur des stratégies SQL Server.	Toute instance de serveur qui héberge un réplica de disponibilité.*
Test-SqlAvailabilityReplica	Évalue l'intégrité des réplicas de disponibilité lors de l'évaluation des stratégies de gestion basées sur des stratégies SQL Server.	Toute instance de serveur qui héberge un réplica de disponibilité.*
Test-SqlDatabaseReplicaState	Évalue l'intégrité d'une base de données de disponibilité sur tous les réplicas de disponibilité joints par l'évaluation des stratégies de gestion basées sur des stratégies SQL Server.	Toute instance de serveur qui héberge un réplica de disponibilité.*

*Pour afficher des informations sur tous les réplicas de disponibilité d’un groupe de disponibilité, utilisez l’instance de serveur qui héberge le réplica principal.

Pour plus d’informations, consultez Utiliser les stratégies Always On pour afficher l’intégrité d’un groupe de disponibilité (SQL Server).

Voir aussi

Vue d’ensemble des groupes de disponibilité Always On (SQL Server)
Get Help SQL Server PowerShell