Vue d'ensemble des applets de commande PowerShell pour les groupes de disponibilité AlwaysOn (SQL Server)

Article
06/25/2013

Microsoft PowerShell est un interpréteur de ligne de commande et un langage de script basé sur des tâches et conçu tout spécialement pour l'administration système. Groupes de disponibilité AlwaysOn fournit un ensemble d'applets de commande PowerShell dans SQL Server 2012 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é.

[!REMARQUE]

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.

Cette rubrique présente les applets de commande pour les ensembles de tâches suivants :

Configuration d'une instance de serveur pour les groupes de disponibilité AlwaysOn
Sauvegarde et restauration de bases de données et de journaux de transactions
Création et gestion d'un groupe de disponibilité
Création et gestion d'un écouteur de groupe de disponibilité
Création et gestion d'un réplica de disponibilité
Ajout et gestion d'une base de données de disponibilité
Surveillance de l'intégrité d'un groupe de disponibilité

[!REMARQUE]

Pour obtenir une liste de rubriques dans la documentation en ligne de SQL Server 2012 qui décrivent le mode d'utilisation des applets de commande pour effectuer des tâches Groupes de disponibilité AlwaysOn, consultez la section « Tâches associées » de Vue d'ensemble des groupes de disponibilité AlwaysOn (SQL Server).

Configuration d'une instance de serveur pour les groupes de disponibilité AlwaysOn

Applets de commande	Description	Prise en charge sur
Disable-SqlAlwaysOn	Désactive la fonctionnalité Groupes de disponibilité AlwaysOn sur une instance de serveur.	Instance de serveur spécifiée par le paramètre Path, InputObject ou Name. (Il doit s'agir d'une édition de SQL Server 2012 qui prend en charge Groupes de disponibilité AlwaysOn.)
Enable-SqlAlwaysOn	Active Groupes de disponibilité AlwaysOn sur une instance de SQL Server 2012 qui prend en charge la fonctionnalité Groupes de disponibilité AlwaysOn. Pour plus d'informations sur la prise en charge de Groupes de disponibilité AlwaysOn, consultez Conditions préalables requises, restrictions et recommandations pour les groupes de disponibilité AlwaysOn (SQL Server).	Toute édition de SQL Server 2012 qui prend en charge Groupes de disponibilité AlwaysOn.
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é AlwaysOn et ne dispose pas d'un point de terminaison de mise en miroir de bases de données

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]

Sauvegarde et restauration des bases de données et 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é AlwaysOn, 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é AlwaysOn, instance de serveur qui héberge un réplica secondaire) Important Lorsque 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).

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]

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.

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]

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

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]

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

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]

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é.

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]

Surveillance de l'intégrité du 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.

Remarque relative à la sécurité
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.	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.	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.	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 AlwaysOn pour afficher l'intégrité d'un groupe de disponibilité (SQL Server).

Icône de flèche utilisée avec le lien Retour en haut [Haut de la page]