Commande nscontrol enable

Mis à jour : 5 décembre 2005

Active l'instance, l'application ou le composant SQL Server Notification Services spécifié.

Syntaxe

nscontrol enable 
    [-nologo]
    [-help]
    [< component > [...n]]
        -name instanceName
    [-server databaseServer]
    [-application applicationName]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]

< component > ::=
    -events [systemName]
    | -generator
    | -distributor [ systemName ]
    | -subscriptions
    | -subscribers 

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.

• < component >
  Spécifie le composant à activer. Vous pouvez spécifier zéro ou plusieurs composants lors de l'exécution de nscontrol enable.

  Si vous ne spécifiez pas de nom de composant, tous les composants de l'instance ou de l'application sont activés. Si vous spécifiez un composant mais pas de nom d'application avec l'argument -application, tous les composants correspondants dans toutes les applications hébergées par l'instance sont activés.

  < component> peut prendre l'un des arguments suivants :

  Argument	Description
  -distributor [systemName]	Active la distribution pour l'instance ou l'application. Si vous spécifiez un nom de système de serveur de distribution, seuls les serveurs de distribution sur ce système sont activés. Sinon, tous les serveurs de distribution pour l'instance ou l'application sont activés.
  -events [systemName]	Active les fournisseurs d'événements hébergés pour l'instance ou l'application. Si vous spécifiez -events, seuls les fournisseurs d'événements hébergés sur ce système sont activés. Sinon, tous les fournisseurs d'événements hébergés pour l'instance ou l'application sont activés.
  -generator	Active le générateur.
  -subscriptions	Active la gestion d'abonnement.
  -subscribers	Active la gestion d'abonnement pour l'instance de Notification Services.

• -nameinstanceName
  Nom de l'instance affectée par nscontrol enable. Si vous spécifiez l'argument –name sans spécifier –application ou un composant, nscontrol active toutes les applications et tous les composants de l'instance.

  Voir l'argument -server pour des informations sur l'utilisation de l'argument -name avec l'argument -server.

• -serverdatabaseServer
  Nom du serveur qui héberge les bases de données d'instance et d'application. Si vous utilisez une instance nommée de 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 enable 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 d'instance SQL Server en lisant les informations de Registre de l'instance.

  Lorsque vous exécutez nscontrol enable sur un système où l'instance n'est pas inscrite, vous devez utiliser les arguments -name et -server, car l'utilitaire nscontrol nécessite le nom de l'instance de Notification Services et le 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.

• -applicationapplicationName
  Nom de l'application pour laquelle un ou tous les composants sont activés. Si vous ne spécifiez pas de nom d'application, les composants spécifiés sont activés pour toutes les applications hébergées par l'instance.

• -sqlusernamesqlUserName
  Nom d'ouverture de session de SQL Server utilisé pour établir une connexion à SQL Server.

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

  Si vous utilisez l'authentification Windows, ne spécifiez pas les arguments -sqlusername et -sqlpassword.

  Important :
  Utilisez si possible l'authentification Windows.

• -sqlpasswordsqlPassword
  Mot de passe associé au nom d'ouverture de session -sqlusername. Cet argument doit être utilisé avec l'argument -sqlusername.

Notes

La commande nscontrol enable attribue aux composants spécifiés l'état Activer la mise en attente en mettant à jour une valeur dans une base de données. L'état de l'instance est stocké dans la base de données d'instance. L'état des composants individuels est stocké dans la base de données d'application.

Lorsque vous exécutez nscontrol enable, Notification Services diffuse la modification d'état souhaitée à tous les composants. L'état change d'Activer la mise en attente à Activé une fois que tous les composants en cours d'exécution ont répondu à la modification. À l'exception des composants d'abonné et d'abonnement, le moteur (généralement le service Windows NS$instance_name) doit être en cours d'exécution pour permettre aux états de composant de passer d'Activer la mise en attente à Activé. Cependant, la modification de l'état depuis Activer la mise en attente à Désactivé ou depuis Désactiver la mise en attente à Activé n'impose pas que le service soit en cours d'exécution, car ces actions annulent simplement une opération en attente.

Une fois que nscontrol enable a modifié la base de données, il affiche l'état actuel de l'instance, des applications et des composants. Pour les descriptions des valeurs d'état, consultez Affichage de l'état des instances, des applications et des composants.

Lorsqu'un service NS$<instance_name> démarre, il détermine où il s'exécute (son nom d'hôte), puis compare cette valeur à la valeur SystemName de chaque serveur de distribution, fournisseur d'événements hébergé et générateur. Si le nom d'hôte correspond à la valeur SystemName, le service vérifie l'état du composant. Si le composant est activé, il démarre.

Pendant que le service est en cours d'exécution, il vérifie la base de données toutes les 30 secondes pour déterminer l'état des fournisseurs d'événements hébergés, du générateur et des serveurs de distribution.

L'état des abonnés et des abonnements est mis en mémoire cache sur le serveur de base de données et les objets de gestion d'abonnement vérifient cet état avant d'effectuer des opérations d'abonnement ou d'abonné.

Autorisations

Le compte utilisé pour exécuter nscontrol enable, ou le nom d'ouverture de session SQL Server spécifié par l'argument -sqlusername, peuvent obtenir les autorisations nécessaires en tant que membre du rôle de base de données NSAdmin dans des bases de données d'application et d'instance spécifiques. Les membres du rôle de base de données db_owner et des rôles de serveur sysadmin et dbcreator fixes peuvent aussi exécuter nscontrol enable.

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

A. Activation d'une instance de Notification Services

L'exemple suivant active l'intégralité d'une instance de Notification Services, nommée StockInstance. L'instance doit être inscrite sur l'ordinateur où vous exécutez la commande suivante.

nscontrol enable -name StockInstance

B. Activation d'une seule application

L'exemple suivant active tous les composants de l'application Stock hébergée par l'instance StockInstance de Notification Services. La commande nscontrol utilise l'authentification Windows pour la connexion à SQL Server. L'instance doit être inscrite sur l'ordinateur où vous exécutez la commande.

nscontrol enable -name StockInstance -application Stock

C. Activation de tous les fournisseurs d'événements hébergés

L'exemple suivant active les fournisseurs d'événements hébergés de toutes les applications dans l'instance StockInstance de Notification Services. La commande nscontrol utilise l'authentification Windows pour la connexion à SQL Server. L'instance doit être inscrite sur l'ordinateur où vous exécutez la commande.

nscontrol enable -name StockInstance -events

D. Activation d'une instance à partir d'un ordinateur d'administration

Si vous exécutez nscontrol enable à partir d'un ordinateur où l'instance StockInstance n'est pas inscrite, vous devez fournir le nom de l'instance SQL Server à l'aide de l'argument -server. L'exemple suivant indique comment activer une instance lorsque les bases de données se trouvent sur une instance de SQL Server nommée nsuetest. La commande nscontrol utilise l'authentification Windows pour la connexion à SQL Server.

nscontrol enable -name StockInstance -server nsuetest

E. Utilisation de l'authentification SQL Server pour activer une instance de Notification Services

L'exemple suivant active l'intégralité d'une instance de Notification Services nommée StockInstance, en utilisant l'authentification SQL Server pour se connecter à SQL Server. L'instance doit être inscrite sur l'ordinateur où vous exécutez la commande suivante.

nscontrol enable -name StockInstance -sqlusername SqlUser 
    -sqlpassword sQl-P@sWd

Voir aussi

Référence

Utilitaire nscontrol

Autres ressources

Activation et désactivation d'instances, d'applications ou de composants

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications