Partager via

Enable-SqlAlwaysOn

  • Référence
Module:
SQLServer

Active la fonctionnalité Groupes de disponibilité Always On.

Syntaxe

Enable-SqlAlwaysOn
      [[-Path] <String>]
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      [-InputObject] <Server>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      -ServerInstance <String>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Enable-SqlAlwaysOn active Always On sur une instance de SQL Server.

Si la fonctionnalité Groupes de disponibilité Always On est activée pendant l’exécution du service SQL Server, le service du moteur de base de données doit être redémarré pour que les modifications soient terminées.

Sauf si vous spécifiez le paramètre Force, l’applet de commande vous invite à redémarrer le service.

Si la fonctionnalité Groupes de disponibilité Always On est déjà activée, aucune action n’est effectuée.

Cette applet de commande peut s’exécuter sur un service distant.

Vous devez disposer des autorisations d’administrateur pour exécuter cette applet de commande.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Exemples

Exemple 1 : Activer les groupes de disponibilité Always On sur le chemin d’accès spécifié

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"

Cette commande active les groupes de disponibilité Always On sur l’instance de SQL Server située sur le chemin spécifié. Cette modification nécessite le redémarrage de l’instance et vous serez invité à confirmer ce redémarrage.

Exemple 2 : Activer les groupes de disponibilité Always On sur le chemin spécifié et redémarrer le serveur sans confirmation

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force

Cette commande active les groupes de disponibilité Always On sur l’instance de SQL Server située sur le chemin spécifié. L’option Force entraîne le redémarrage de l’instance de serveur sans vous inviter à confirmer.

Exemple 3 : Activer les groupes de disponibilité Always On pour l’instance de serveur spécifiée

PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance"

Cette commande active les groupes de disponibilité Always On sur l’instance de SQL Server nommée Computer\Instance. Cette modification nécessite le redémarrage de l’instance et vous serez invité à confirmer ce redémarrage.

Exemple 4 : Activer les groupes de disponibilité Always On pour l’instance de serveur spécifiée à l’aide de l’authentification Windows

PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")

Cette commande active les groupes de disponibilité Always On sur l’instance de SQL Server nommée « Computer\Instance » à l’aide de l’authentification Windows. Vous serez invité à entrer le mot de passe du compte spécifié. Cette modification nécessite le redémarrage de l’instance, et vous serez également invité à confirmer ce redémarrage.

Exemple 5 : Activer les groupes de disponibilité Always On sur le chemin d’accès spécifié sans redémarrer le serveur

PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart

Cette commande active les groupes de disponibilité Always On sur l’instance SQL Server située sur le chemin d’accès spécifié, mais la commande ne redémarre pas l’instance. La modification n’aura pas lieu tant que vous ne redémarrez pas manuellement cette instance de serveur.

Paramètres

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie le nom de l’instance SQL Server sur laquelle activer la fonctionnalité Groupes de disponibilité Always On. Le format est MACHINENAME\INSTANCE. Pour activer ce paramètre sur un serveur distant, utilisez-le avec le paramètre Credential.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur. Ce paramètre est fourni pour permettre la construction de scripts.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie l’objet serveur de l’instance SQL Server.

Type:Server
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NoServiceRestart

Indique que l’utilisateur n’est pas invité à redémarrer le service SQL Server. Vous devez redémarrer manuellement le service SQL Server pour que les modifications prennent effet. Lorsque ce paramètre est défini, Force est ignoré.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès à l’instance SQL Server. Il s’agit d’un paramètre facultatif. S’il n’est pas spécifié, l’emplacement de travail actuel est utilisé.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:ActionPreference
Alias:proga
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerInstance

Spécifie le nom de l’instance SQL Server. Le format est MACHINENAME\INSTANCE. Pour activer ce paramètre sur un serveur distant, utilisez-le avec le paramètre Credential.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.SqlServer.Management.Smo.Server

System.String

Sorties

System.Object