Commande nscontrol upgrade

Mis à jour : 5 décembre 2005

Met à niveau des instances de Microsoft SQL Server Notification Services d'une version antérieure ou d'une édition inférieure à la version et l'édition actuelles.

Vous ne pouvez pas rétrograder une instance de Notification Services à une version antérieure ou une édition inférieure.

Syntaxe

nscontrol upgrade
    [-nologo]
    [-help]
        –name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-timeout seconds]

Arguments

• -nologo
  Supprime les informations de produit et de version qui s'affichent lorsque vous exécutez une commande nscontrol.

• -help
  Affiche la syntaxe de la commande.

• -nameinstanceName
  Nom de l'instance à mettre à niveau.

• -serverdatabaseServer
  Spécifie le nom du serveur qui héberge les bases de données d'instance et d'application. Si vous utilisez une instance nommée de Microsoft SQL Server pour héberger les bases de données, vous devez spécifier le nom du serveur et le nom de l'instance en utilisant le format <servername>\<instancename>.

  Lorsque vous exécutez nscontrol upgrade sur un système où l'instance a précédemment été inscrite avec la commande nscontrol register, utilisez l'argument -name mais pas l'argument -server. L'utilitaire nscontrol détermine le nom de l'instance SQL Server en lisant les informations de Registre de l'instance.

  Lorsque vous exécutez nscontrol upgrade sur un système où l'instance n'est pas inscrite, vous devez utiliser les arguments -name et -server, car l'utilitaire nscontrol a besoin du nom de l'instance de Notification Services et du nom de l'instance de SQL Server pour localiser la base de données d'instance.

  Lorsque vous spécifiez l'argument -server, l'utilitaire nscontrol ignore toute valeur de Registre pour l'instance.

• -sqlusernamesqlUserName
  Nom d'ouverture de session de SQL Server utilisé par nscontrol pour la connexion à SQL Server.

  Important :
  L'authentification Windows est plus sûre que l'authentification SQL Server. Utilisez l'authentification Windows chaque fois que c'est possible.

  Si vous devez utiliser l'authentification SQL Server pour la connexion à SQL Server, spécifiez un nom d'ouverture de session à l'aide de cet argument. Spécifiez également un mot de passe avec l'argument -sqlpassword.

  Si vous utilisez l'authentification Windows pour la connexion à SQL Server, n'utilisez pas les arguments -sqlusername et -sqlpassword.

• -sqlpasswordsqlPassword
  Mot de passe associé à l'ID de connexion -sqlusername. Cet argument doit être utilisé uniquement lors d'une connexion à l'aide de l'authentification SQL Server.

• -timeout seconds
  Délai d'attente, en secondes, pour l'exécution de chaque action de mise à niveau. Le délai d'attente par défaut est de 30 secondes. Si vous recevez des erreurs de délai d'attente lors d'une tentative de mise à niveau d'une instance de Notification Services, définissez une valeur de délai d'attente plus longue.

Notes

Important :
Il est recommandé de sauvegarder les bases de données d'instance et d'application avant de procéder à la mise à niveau.

Important :
Après l'exécution de nscontrol upgrade, exécutez nscontrol register pour mettre à niveau les informations de Registre de l'instance.

Lorsque vous exécutez nscontrol upgrade, la version ou l'édition de nscontrol détermine la version ou l'édition de la mise à niveau. Par exemple, si une instance a été créée en utilisant la version 2.0.3008.0 de Notification Services et si vous souhaitez mettre à niveau l'instance vers la version 9.0.242, exécutez nscontrol upgrade à partir du dossier 9.0.242\bin pour effectuer la mise à niveau.

La commande nscontrol upgrade vérifie la base de données d'instance pour déterminer la version et l'édition des métadonnées. Si les métadonnées spécifient une version ou une édition antérieure, nscontrol upgrade vérifie ensuite que l'instance est désactivée ; si l'instance est désactivée, nscontrol effectue la mise à niveau.

Remarque :
nscontrol upgrade attribue au mode de compatibilité de la base de données la valeur 90.

La commande nscontrol upgrade sert à mettre à niveau une instance de Notification Services. Si vous déplacez l'instance pendant la mise à niveau, vous devez modifier les valeurs de SystemName du fichier de définition d'application (ADF), puis utiliser nscontrol update pour mettre à jour les valeurs dans les bases de données. Si les valeurs de SystemName dans des bases de données ne correspondent pas aux noms de systèmes réels, les composants ne s'exécutent pas et Notification Services ne peut pas traiter les notifications. Pour plus d'informations sur le déplacement d'instances, consultez Déplacement d'instances de Notification Services.

Autorisations

Le compte utilisé pour exécuter nscontrol upgrade, ou le nom d'ouverture de session SQL Server spécifié par l'argument -sqlusername, doit être membre du rôle de base de données fixe db_owner ou du rôle de serveur fixe sysadmin.

Le compte doit également être autorisé à exécuter les fichiers binaires de Notification Services. Cette autorisation est octroyée aux membres des groupes Administrateurs et SQLServerNotificationServicesUser Windows.

Exemples

Les exemples suivants illustrent la mise à niveau d'une instance dans deux situations différentes.

A. Mise à niveau d'une instance avec l'authentification Windows

Cet exemple illustre la mise à niveau d'une instance de Notification Services nommée StockInstance en utilisant l'authentification Windows pour la connexion à SQL Server.

nscontrol upgrade -name StockInstance -server nsuetest

B. Mise à niveau d'une instance avec l'authentification SQL Server

Important :
Utilisez si possible l'authentification Windows.

Cet exemple illustre la mise à niveau d'une instance de Notification Services nommée StockInstance en utilisant l'authentification SQL Server pour la connexion à SQL Server.

nscontrol upgrade -name StockInstance -server nsuetest
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

Voir aussi

Référence

Utilitaire nscontrol

Autres ressources

Migration des instances Notification Services

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
5 décembre 2005	Nouveau contenu : Informations supplémentaires relatives au groupe SQLServerNotificationServicesUser Windows.