Enable-SqlAlwaysOn

  • Référence
Module:
SQLServer

Active la fonctionnalité Always On groupes de disponibilité.

Syntax

Enable-SqlAlwaysOn
      [[-Path] <String>]
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      [-InputObject] <Server>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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é Always On groupes de disponibilité 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é Always On groupes de disponibilité est déjà activée, aucune action n’est effectuée.

Cette applet de commande peut être exécutée 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 Always On groupes de disponibilité au niveau du chemin d’accès spécifié

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

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

Exemple 2 : Activer Always On groupes de disponibilité au chemin d’accès spécifié et redémarrer le serveur sans confirmation

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

Cette commande active Always On groupes de disponibilité 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 : Activer Always On groupes de disponibilité pour l’instance de serveur spécifiée

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

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

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

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

Cette commande active Always On groupes de disponibilité sur l’instance de SQL Server nommée « Computer\Instance » à l’aide de Authentification Windows. Vous serez invité à entrer le mot de passe pour le 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 Always On groupes de disponibilité au niveau du chemin spécifié sans redémarrer le serveur

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

Cette commande active Always On groupes de disponibilité sur l’instance SQL Server située au chemin d’accès spécifié, mais la commande ne redémarre pas l’instance. La modification n'entre pas en vigueur tant que vous n'avez pas redémarré manuellement cette instance de serveur.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Spécifie le nom de l’instance SQL Server sur laquelle activer la fonctionnalité Always On groupes de disponibilité. 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:Server
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.SqlServer.Management.Smo.Server

System.String

Sorties

System.Object