Vue d’ensemble des applets de commande PowerShell pour les groupes de disponibilité Always On (SQL Server)Overview of PowerShell Cmdlets for Always On Availability Groups (SQL Server)

Cette rubrique s’applique à : OuiSQL Serveraucunbase de données SQL AzureaucunAzure SQL Data Warehouse aucun Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

MicrosoftMicrosoft 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. PowerShell is a task-based command-line shell and scripting language designed especially for system administration. Groupes de disponibilité Always OnAlways On availability groups fournit un ensemble d'applets de commande PowerShell dans SQL Server 2017SQL Server 2017 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é. provides a set of PowerShell cmdlets in SQL Server 2017SQL Server 2017 that enable you to deploy, manage, and monitor availability groups, availability replicas, and availability databases.

Note

Une applet de commande PowerShell peut s'effectuer en initiant correctement une action.A PowerShell cmdlet can complete by successfully initiating an action. Cela n'indique pas si le travail prévu, tel que le basculement d'un groupe de disponibilité, est terminé.This does not indicate that the intended work, such as the fail over of an availability group, has completed. 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.When scripting a sequence of actions, you might have to check the status of actions, and wait for them to complete.

Cette rubrique présente les applets de commande pour les ensembles de tâches suivants :This topic introduces the cmdlets for the following sets of tasks:

Note

Pour obtenir la liste des rubriques de la documentation en ligne SQL Server 2017SQL Server 2017 qui expliquent comment utiliser les applets de commande pour effectuer des tâches Groupes de disponibilité Always OnAlways On availability groups , consultez la section « Tâches associées » de l’article Vue d’ensemble des groupes de disponibilité Always On (SQL Server).For a list of topics in SQL Server 2017SQL Server 2017 Books Online that describe how to use cmdlets to perform Groupes de disponibilité Always OnAlways On availability groups tasks, see the "Related Tasks" section of Overview of Always On Availability Groups (SQL Server).

Configuring a Server Instance for Always On Availability GroupsConfiguring a Server Instance for Always On Availability Groups

Applets de commandeCmdlets DescriptionDescription Prise en charge surSupported on
Disable-SqlAlwaysOnDisable-SqlAlwaysOn Désactive la fonctionnalité Groupes de disponibilité Always OnAlways On availability groups sur une instance de serveur.Disables the Groupes de disponibilité Always OnAlways On availability groups feature on a server instance. Instance de serveur spécifiée par le paramètre Path, InputObjectou Name .The server instance that is specified by the Path, InputObject, or Name parameter. (Il doit s'agir d'une édition de SQL ServerSQL Server qui prend en charge Groupes de disponibilité Always OnAlways On availability groups.)(Must be an edition of SQL ServerSQL Server that supports Groupes de disponibilité Always OnAlways On availability groups.)
Enable-SqlAlwaysOnEnable-SqlAlwaysOn Active Groupes de disponibilité Always OnAlways On availability groups sur une instance de SQL Server 2017SQL Server 2017 qui prend en charge la fonctionnalité Groupes de disponibilité Always OnAlways On availability groups .Enables Groupes de disponibilité Always OnAlways On availability groups on an instance of SQL Server 2017SQL Server 2017 that supports the Groupes de disponibilité Always OnAlways On availability groups feature. Pour plus d’informations sur la prise en charge des Groupes de disponibilité Always OnAlways On availability groups, consultez Conditions préalables requises, restrictions et recommandations pour les groupes de disponibilité Always On (SQL Server).For information about support for Groupes de disponibilité Always OnAlways On availability groups, see Prerequisites, Restrictions, and Recommendations for Always On Availability Groups (SQL Server). Toute édition de SQL ServerSQL Server qui prend en charge Groupes de disponibilité Always OnAlways On availability groups.Any edition of SQL ServerSQL Server that supports Groupes de disponibilité Always OnAlways On availability groups.
New-SqlHadrEndPointNew-SqlHadrEndPoint Crée un nouveau point de terminaison de mise en miroir de bases de données sur une instance de serveur.Creates a new database mirroring endpoint on a server instance. Ce point de terminaison est requis pour le déplacement des données entre des bases de données primaires et secondaires.This endpoint is required for data movement between primary and secondary databases. Toute instance de SQL ServerSQL ServerAny instance of SQL ServerSQL Server
Set-SqlHadrEndpointSet-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.Changes the properties of an existing database mirroring endpoint, such as the name, state, or authentication properties. Instance de serveur qui prend en charge Groupes de disponibilité Always OnAlways On availability groups et ne dispose pas d'un point de terminaison de mise en miroir de bases de donnéesA server instance that supports Groupes de disponibilité Always OnAlways On availability groups and lacks a database mirroring endpoint

Backing Up and Restoring Databases and Transaction LogsBacking Up and Restoring Databases and Transaction Logs

Applets de commandeCmdlets DescriptionDescription Prise en charge surSupported on
Backup-SqlDatabaseBackup-SqlDatabase Crée une sauvegarde de données ou de journal.Creates a data or log backup. Base de données en ligne (pour Groupes de disponibilité Always OnAlways On availability groups, base de données sur l'instance de serveur qui héberge le réplica principal)Any online database (for Groupes de disponibilité Always OnAlways On availability groups, a database on the server instance that hosts the primary replica)
Restore-SqlDatabaseRestore-SqlDatabase Restaure une sauvegarde.Restores a backup. Instance de SQL ServerSQL Server (pour Groupes de disponibilité Always OnAlways On availability groups, instance de serveur qui héberge un réplica secondaire)Any instance of SQL ServerSQL Server (for Groupes de disponibilité Always OnAlways On availability groups, a server instance that hosts a secondary replica)

** Important *\* Quand vous préparez une base de données secondaire, vous devez utiliser le paramètre -NoRecovery dans chaque commande Restore-SqlDatabase .** Important *\* When preparing a secondary database, you must use the -NoRecovery parameter in every Restore-SqlDatabase command.

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).For information about using these cmdlets to prepare a secondary database, see Manually Prepare a Secondary Database for an Availability Group (SQL Server).

Creating and Managing an Availability GroupCreating and Managing an Availability Group

Applets de commandeCmdlets DescriptionDescription Prise en charge surSupported on
New-SqlAvailabilityGroupNew-SqlAvailabilityGroup Crée un groupe de disponibilité.Creates a new availability group. Instance de serveur pour héberger le réplica principalServer instance to host primary replica
Remove-SqlAvailabilityGroupRemove-SqlAvailabilityGroup Supprime un groupe de disponibilitéDeletes availability group. Instance de serveur activée pour le service HADRHADR-enabled server instance
Set-SqlAvailabilityGroupSet-SqlAvailabilityGroup Définit les propriétés d'un groupe de disponibilité ; met un groupe de disponibilité en ligne/hors connexionSets the properties of an availability group; take an availability group online/offline Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica
Switch-SqlAvailabilityGroupSwitch-SqlAvailabilityGroup Démarre l'une des formes de basculement suivantes :Initiates one of the following forms of failover:

Basculement forcé d'un groupe de disponibilité (avec possible perte de données).A forced failover of an availability group (with possible data loss).

Basculement manuel d'un groupe de disponibilité.A manual failover of an availability group.
Instance de serveur qui héberge le réplica secondaire cible.Server instance that hosts target secondary replica

Creating and Managing an Availability Group ListenerCreating and Managing an Availability Group Listener

Applet de commandeCmdlet DescriptionDescription Prise en charge surSupported on
New-SqlAvailabilityGroupListenerNew-SqlAvailabilityGroupListener Crée un écouteur de groupe de disponibilité et l'attache à un groupe de disponibilité existant.Creates a new availability group listener and attaches it to an existing availability group. Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica
Set-SqlAvailabilityGroupListenerSet-SqlAvailabilityGroupListener Modifie le paramètre de port sur un écouteur de groupe de disponibilité existant.Modifies the port setting on an existing availability group listener. Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica
Add-SqlAvailabilityGroupListenerStaticIpAdd-SqlAvailabilityGroupListenerStaticIp Ajoute une adresse IP statique à une configuration existante d'écouteur de groupe de disponibilité.Adds a static IP address to an existing availability group listener configuration. L'adresse IP peut être une adresse IPv4 avec sous-réseau ou une adresse IPv6.The IP address can be an IPv4 address with subnet, or an IPv6 address. Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica

Creating and Managing an Availability ReplicaCreating and Managing an Availability Replica

Applets de commandeCmdlets DescriptionDescription Prise en charge surSupported on
New-SqlAvailabilityReplicaNew-SqlAvailabilityReplica Crée un réplica de disponibilité.Creates a new availability replica. 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é.You can Use the -AsTemplate parameter to create an in-memory availability-replica object for each new availability replica. Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica
Join-SqlAvailabilityGroupJoin-SqlAvailabilityGroup Joint un réplica secondaire au groupe de disponibilité.Joins a secondary replica to the availability group. Instance de serveur qui héberge le réplica secondaire.Server instance that hosts secondary replica
Remove-SqlAvailabilityReplicaRemove-SqlAvailabilityReplica Supprime un réplica de disponibilité.Deletes an availability replica. Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica
Set-SqlAvailabilityReplicaSet-SqlAvailabilityReplica Définit les propriétés d'un réplica de disponibilité.Sets the properties of an availability replica. Instance de serveur qui héberge le réplica principalServer instance that hosts primary replica

Adding and Managing an Availability DatabaseAdding and Managing an Availability Database

Applets de commandeCmdlets DescriptionDescription Prise en charge surSupported on
Add-SqlAvailabilityDatabaseAdd-SqlAvailabilityDatabase Sur le réplica principal, ajoute une base de données à un groupe de disponibilité.On the primary replica, adds a database to an availability group.

Sur un réplica secondaire, joint une base de données secondaire à un groupe de disponibilité.On a secondary replica, joins a secondary database to an availability group.
Instance de serveur qui héberge un réplica de disponibilité (le comportement diffère pour les réplicas principal et secondaire)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Remove-SqlAvailabilityDatabaseRemove-SqlAvailabilityDatabase Sur le réplica principal, supprime la base de données du groupe de disponibilité.On the primary replica, removes the database from the availability group.

Sur un réplica secondaire, supprime la base de données secondaire locale du réplica secondaire local.On a secondary replica, removes the local secondary database from the local secondary replica.
Instance de serveur qui héberge un réplica de disponibilité (le comportement diffère pour les réplicas principal et secondaire)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Resume-SqlAvailabilityDatabaseResume-SqlAvailabilityDatabase Reprend le déplacement des données pour une base de données de disponibilité interrompue.Resumes the data movement for a suspended availability database. Instance de serveur sur laquelle la base de données a été interrompue.The server instance on which the database was suspended.
Suspend-SqlAvailabilityDatabaseSuspend-SqlAvailabilityDatabase Interrompt le déplacement des données pour une base de données de disponibilité.Suspends the data movement for an availability database. Instance de serveur qui héberge un réplica de disponibilité.Any server instance that hosts an availability replica.

Monitoring Availability Group HealthMonitoring Availability Group Health

Les applets de commande SQL ServerSQL Server suivantes vous permettent de surveiller l'intégrité d'un groupe de disponibilité et de ses réplicas et bases de données.The following SQL ServerSQL Server cmdlets enable you to monitor the health of an availability group and its replicas and databases.

Important

Vous devez disposer des autorisations CONNECT, VIEW SERVER STATE et VIEW ANY DEFINITION pour exécuter ces applets de commande.You must have CONNECT, VIEW SERVER STATE, and VIEW ANY DEFINITION permissions to execute these cmdlets.

Applet de commandeCmdlet DescriptionDescription Prise en charge surSupported on
Test-SqlAvailabilityGroupTest-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.Assesses the health of an availability group by evaluating SQL Server policy based management (PBM) policies. Toute instance de serveur qui héberge un réplica de disponibilité.Any server instance that hosts an availability replica.
Test-SqlAvailabilityReplicaTest-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.Assesses the health of availability replicas by evaluating SQL Server policy based management (PBM) policies. Toute instance de serveur qui héberge un réplica de disponibilité.Any server instance that hosts an availability replica.
Test-SqlDatabaseReplicaStateTest-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.Assesses the health of an availability database on all joined availability replicas by evaluating SQL Server policy based management (PBM) policies. Toute instance de serveur qui héberge un réplica de disponibilité.Any server instance that hosts an availability replica.

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.To view information about all of the availability replicas in an availability group, use to the server instance that hosts the primary replica.

Pour plus d’informations, consultez Utiliser les stratégies Always On pour afficher l’intégrité d’un groupe de disponibilité (SQL Server).For more information, see Use Always On Policies to View the Health of an Availability Group (SQL Server).

Voir aussiSee Also

Vue d’ensemble des groupes de disponibilité Always On (SQL Server) Overview of Always On Availability Groups (SQL Server)
Obtenir de l’aide sur SQL Server PowerShellGet Help SQL Server PowerShell