Enable-SqlAlwaysOn
Active la fonctionnalité Groupes de disponibilité Always On.
Syntaxe
ByPath (Par défaut)
Enable-SqlAlwaysOn
[[-Path] <String>]
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Enable-SqlAlwaysOn
[-InputObject] <Server>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Enable-SqlAlwaysOn
-ServerInstance <String>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-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.
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 |
-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.
Propriétés du paramètre
| Type: | PSCredential |
| 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 |
-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.
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 |
-InputObject
Spécifie l’objet serveur de l’instance SQL Server.
Propriétés du paramètre
| Type: | Server |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByObject
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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é.
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 |
-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é.
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: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
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
ByName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| 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.