Commande nscontrol status

Article
12/15/2008

Mis à jour : 5 décembre 2005

Affiche l'état activé ou désactivé de l'instance spécifiée, des applications et de leurs composants. Affiche également l'état du ou des services NS$<instance_name> Windows associés à cette instance.

Syntaxe

nscontrol status 
    [-nologo]
    [-help]
        -name instanceName
    [-server databaseServer] 
    [-application applicationName] 
    [-sqlusername sqlUserName -sqlpassword sqlPassword]

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 dont l'état est demandé.

-serverdatabaseServer
Nom du serveur qui héberge les bases de données d'instance et d'application.

Si vous exécutez nscontrol status sur un système où l'instance est inscrite, utilisez l'argument -name et non pas l'argument -server. L'utilitaire nscontrol détermine le nom d'instance Microsoft SQL Server en lisant les informations de Registre de l'instance.

Lorsque vous exécutez nscontrol status 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 celui de SQL Server.

-applicationapplicationName
Nom de l'application dont l'état est demandé. Si vous ne spécifiez pas de nom d'application, nscontrol status indique l'état de toutes les applications qui sont hébergées par l'instance.

-sqlusernamesqlUserName
Si vous utilisez l'authentification SQL Server pour la connexion à SQL Server, vous devez spécifier les arguments -sqlusername et -sqlpassword.

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

-sqlpasswordsqlPassword
Mot de passe associé à l'ID de connexion -sqlusername. Cet argument doit être utilisé conjointement avec l'argument -sqlusername.

Notes

La commande nscontrol status affiche l'état de chaque composant, avec le nom du système entre parenthèses.

Les fournisseurs d'événements, le générateur et les serveurs de distribution peuvent posséder les valeurs d'état suivantes : Activer, Activer la mise en attente, Désactivé et Désactiver la mise en attente. Pour les descriptions des valeurs d'état possibles, consultez Affichage de l'état des instances, des applications et des composants.

L'état des composants est mis à jour lors du démarrage du service. Si vous faites évoluer une instance sur plusieurs ordinateurs, vous devez démarrer tous les services Windows pour tous les états à mettre à jour.

Les abonnés et les abonnements peuvent avoir l'état Activé ou Désactivé. Ces composants ne sont pas dépendants du service NS$instance_name de Windows.

La commande nscontrol enable et la commande nscontrol disable affichent également des informations d'état.

Autorisations

Le compte utilisé pour exécuter nscontrol status, ou l'ID de connexion SQL Server spécifié par l'argument -sqlusername, doit être membre des rôles de bases de données suivants : NSAnalysis, NSDistributor, NSEventProvider, NSGenerator, NSReader, NSRunService, NSSubscriberAdmin ou NSVacuum.

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.

Si vous utilisez les services NS$<instanceName> Windows qui exécutent l'instance de Notification Services, nscontrol status affiche l'état des services ; par conséquent, le compte doit être de type Administrateur sur tous les ordinateurs où le service Windows s'exécute.

Exemples

Les exemples suivants illustrent l'affichage de l'état dans plusieurs scénarios.

A. Affichage de l'état d'une instance

Cet exemple illustre l'affichage de l'état d'une instance nommée StockInstance. L'utilitaire nscontrol utilise l'authentification Windows pour la connexion à SQL Server.

nscontrol status -name StockInstance

B. Affichage de l'état d'une application

Cet exemple illustre l'affichage de l'état de l'application boursière nommée StockInstance. L'utilitaire nscontrol utilise l'authentification Windows pour la connexion à SQL Server.

nscontrol status -name StockInstance -application Stock

C. Affichage de l'état d'une instance à partir d'un ordinateur d'administration

Cet exemple illustre l'affichage de l'état d'une instance lorsque cette dernière n'est pas inscrite sur l'ordinateur. Pour afficher l'état, vous devez utiliser l'argument –server pour fournir le nom du serveur de base de données.

L'utilitaire nscontrol utilise l'authentification Windows pour la connexion à SQL Server.

nscontrol status -name StockInstance -server nsuetest 
    -application Stock

D. Affichage de l'état d'une instance utilisant l'authentification SQL Server

Important :
Utilisez si possible l'authentification Windows.

Cet exemple illustre l'affichage de l'état d'une instance nommée StockInstance avec l'authentification SQL Server pour une connexion à SQL Server.

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

Voir aussi

Historique des modifications

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

Partager via