Partager via

Disable-SqlAlwaysOn

  • Référence
Module:
SQLServer

Désactive la fonctionnalité Groupes de disponibilité Always On pour un serveur.

Syntaxe

Disable-SqlAlwaysOn
       [[-Path] <String>]
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-SqlAlwaysOn
       [-InputObject] <Server>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-SqlAlwaysOn
       -ServerInstance <String>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-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.

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 des informations d’identification Windows qui ont l’autorisation de modifier le paramètre Always On sur l’instance SQL Server.

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 de SQL Server où le paramètre Groupes de disponibilité Always On est désactivé.

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

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

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