Disable-SqlAlwaysOn
Désactive la fonctionnalité Groupes de disponibilité Always On pour un serveur.
Syntaxe
ByPath (Par défaut)
Disable-SqlAlwaysOn
[[-Path] <String>]
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Disable-SqlAlwaysOn
[-InputObject] <Server>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Disable-SqlAlwaysOn
-ServerInstance <String>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Disable-SqlAlwaysOn désactive la fonctionnalité des groupes de vailabilité Always On sur une instance SQL Server.
Si la fonctionnalité Groupes de disponibilité Always On est désactivé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à désactivée, cette applet de commande n’apporte aucune modification.
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 : Désactiver les groupes de disponibilité Always On au niveau du chemin d’accès spécifié
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"
Cette commande désactive les groupes de disponibilité Always On sur l’instance de SQL Server située sur le chemin d’accès spécifié. Cette commande nécessite le redémarrage de l’instance de serveur, et vous serez invité à confirmer ce redémarrage.
Exemple 2 : Désactiver les groupes de disponibilité Always On sur le chemin d’accès spécifié et redémarrer le serveur sans confirmation
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force
Cette commande désactive les groupes de disponibilité Always On sur l’instance de SQL Server située sur le chemin d’accès spécifié. L’option Force entraîne le redémarrage de l’instance de serveur sans vous inviter à confirmer.
Exemple 3 : Désactiver les groupes de disponibilité Always On pour l’instance de serveur spécifiée
PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance"
Cette commande désactive les groupes de disponibilité Always On sur l’instance de SQL Server nommée « Computer\Instance ». Cette commande nécessite le redémarrage de l’instance et vous serez invité à confirmer ce redémarrage.
Exemple 4 : Désactiver les groupes de disponibilité Always On pour l’instance de serveur spécifiée à l’aide de l’authentification Windows
PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")
Cette commande désactive 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é, « DOMAIN\Username ». Cette modification nécessite le redémarrage de l’instance et vous serez également invité à confirmer ce redémarrage.
Exemple 5 : Désactiver les groupes de disponibilité Always On sur le chemin d’accès spécifié sans redémarrer le serveur
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart
Cette commande désactive les groupes de disponibilité Always On sur l’instance de 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 des informations d’identification Windows qui ont l’autorisation de modifier le paramètre Always On sur l’instance SQL Server.
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 de SQL Server où le paramètre Groupes de disponibilité Always On est désactivé.
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 de SQL Server. Il s’agit d’un paramètre facultatif. S’il n’est pas spécifié, la valeur de l’emplacement de travail actuel est utilisée.
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 de SQL Server où Always On est désactivé. Le format doit être MACHINENAME\INSTANCE. Utilisez le paramètre Credential pour modifier le paramètre Always On sur un serveur distant.
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.