Commande nscontrol register

Article
12/15/2008

Mis à jour : 5 décembre 2005

Crée ou met à jour des entrées de Registre d'une instance de Notification Services, crée des compteurs de performances pour l'instance et crée éventuellement un service Microsoft Windows d'exécution de l'instance.

Syntaxe

nscontrol register 
    [-nologo]
    [-help]
    -name instanceName
    [-server databaseServer]
    [-service
        [-serviceusername NSServiceUserName [-servicepassword NSServicePwd]
        [-sqlusername NSServiceSqlUserName  -sqlpassword NSServiceSqlPwd]
        [-argumentkey key]]

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

-serverdatabaseServer
Nom du serveur qui héberge la base de données d'instance. Si vous utilisez une instance nommée de SQL Server pour héberger la base de données d'instance, vous devez spécifier le nom du serveur et le nom de l'instance en utilisant le format <servername>\<instancename>. Si vous ne spécifiez pas un nom de serveur de base de données, nscontrol register utilise le nom du serveur local.

-service
Crée le service Windows NS$instance_name qui contrôle l'instance de Notification Services sur le serveur.

Vous utilisez généralement l'argument -server sur un serveur qui exécute un fournisseur d'événements hébergé, un générateur ou un serveur de distribution. Vous n'avez pas besoin d'utiliser cet argument sur les serveurs qui exécutent uniquement des interfaces de gestion d'abonnement, des fournisseurs d'événements non hébergés, ou des applications de gestion.

Si vous hébergez le moteur Notification Services dans votre propre application, n'utilisez pas l'argument -service. Pour plus d'informations sur l'hébergement du moteur, consultez Hébergement du moteur de Notification Services.

-serviceusernameNSServiceUserName
Compte Windows que le service Windows emploie pour accéder aux ressources locales et distantes. Si vous utilisez l'authentification Windows, le service Windows utilise également ce compte pour la connexion à SQL Server et pour accéder aux bases de données d'instance et d'application.

Pour les comptes locaux et de domaine, cet argument doit être utilisé conjointement avec l'argument -servicepassword. Les comptes prédéfinis tels que NetworkService ne possèdent pas de mots de passe.

Dans Microsoft Windows XP, si -serviceusername et -servicepassword ne sont pas spécifiés, le compte NT par défaut AUTHORITY\NetworkService est employé. Pour les autres systèmes d'exploitation, -serviceusername et -servicepassword sont requis.

Remarque :
Pour des raisons de sécurité, le compte de service doit s'exécuter avec des autorisations minimales et non pas comme un administrateur ou comme le compte de service LocalSystem. Pour plus d'informations, consultez Configuration des compte Windows pour une instance de Notification Services.

Si vous utilisez l'authentification Windows, ce compte doit posséder des autorisations dans les bases de données d'instance et d'application. Pour plus d'informations, consultez Configuration des autorisations SQL Server pour une instance de Notification Services.

-servicepasswordNSServicePwd
Mot de passe associé à --serviceusername. Cet argument doit être utilisé avec l'argument -serviceusername.

-sqlusernameNSServiceSqlUserName
Nom d'ouverture de session de SQL Server que le service Windows NS$<instance_name> utilise pour la connexion à SQL Server.

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.

Remarque :
Si vous assignez un nom d'utilisateur et un mot de passe SQL Server à ce service, ces informations sont chiffrées et stockées dans le Registre. Pour éviter de stocker ces informations, utilisez plutôt l'authentification Windows.

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

-argumentkeykey
Valeur utilisée pour chiffrer les arguments du canal de livraison et du fournisseur d'événements qui sont stockés dans les bases de données Notification Services. La clé est utilisée uniquement si l'argument –service est spécifié ; sinon, la clé est ignorée.

Si vous inscrivez l'instance en utilisant une clé de chiffrement, vous devez utiliser la même clé lors de la création et de la mise à jour de l'instance. Pour ce faire, la valeur EncryptArguments dans le fichier de configuration doit être true.

La clé est une chaîne pouvant contenir jusqu'à 2500 caractères. nscontrol register chiffre la valeur de clé et la stocke dans le Registre ; cela permet au service Windows NS$instance_name de lire les arguments chiffrés.

Vous ne pouvez pas modifier la clé après la création de l'instance, opération effectuée avec nscontrol create ou avec la commande Nouvelle instance de Notification Services dans SQL Server Management Studio.

Notes

La commande nscontrol register doit être exécutée localement. Vous ne pouvez pas inscrire Notification Services sur un serveur distant.

Si vous utilisez l'authentification SQL Server pour la connexion à SQL Server et si vous devez mettre à jour le nom d'utilisateur ou le mot de passe SQL Server utilisé par le service, vous devez modifier les informations de connexion à l'aide de nscontrol register ou de la boîte de dialogue Inscrire pour Notification Services dans SQL Server Management Studio. Notification Services chiffre le nom d'utilisateur et le mot de passe, puis les stocke dans le Registre auquel seuls les administrateurs et le service Windows peuvent accéder.

Si vous spécifiez une valeur clé de chiffrement à l'aide de l'argument -argumentkey, la commande nscontrol register chiffre la clé et la stocke dans le Registre. La clé est sécurisée afin que seuls les membres du groupe Administrateurs local et le compte sous lequel s'exécute le service NS$instance_name puissent lire cette clé.

Autorisations

Le compte utilisé pour exécuter nscontrol register 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 créez un service Windows et des compteurs de performances, le compte doit être un membre du groupe Administrateurs.

Pour plus d'informations sur les autorisations requises par le service Windows NS$instance_name pour Notification Services, consultez Sécurisation de Notification Services.

Exemples

Les exemples qui suivent illustrent trois méthodes différentes pour enregistrer une instance.

A. Inscription d'une instance et création d'un service Windows

Cet exemple illustre l'inscription d'une instance nommée StockInstance, en utilisant l'authentification Windows pour la connexion à SQL Server. L'inscription de l'instance à l'aide des arguments suivants crée un service Windows pour l'instance, définit le nom d'utilisateur et le mot de passe employés par le service Windows pour accéder à SQL Server (et pour démarrer des ressources Windows et y accéder) et fournit le nom de l'instance SQL Server qui héberge les bases de données.

nscontrol register -name StockInstance -server nsuetest -service 
    -serviceusername SvcAcct -servicepassword svC-P@sWd

B. Inscription d'une instance sans création d'un service Windows

Cet exemple illustre l'inscription d'une instance nommée StockInstance dans les scénarios suivants :

Une interface de gestion d'abonnements ou un fournisseur d'événements indépendant se trouve sur le serveur, mais le serveur n'exécute pas un fournisseur d'événements hébergés, un générateur ou un serveur de distribution.
Le moteur Notification Services qui héberge les fournisseurs d'événements hébergés, les générateurs et les serveurs de distribution est hébergé par une application personnalisée et le service Windows n'est donc pas nécessaire.

Dans ces scénarios, vous devez inscrire l'instance de façon à ce que ses composants puissent localiser les bases de données, mais vous n'utilisez pas l'argument -server pour créer le service Windows.

Vous pourriez également utiliser cet exemple pour mettre à jour le nom du serveur de base de données dans une entrée de Registre existante.

nscontrol register -name StockInstance -server nsuetest

C. Authentification SQL Server

Important :
Utilisez si possible l'authentification Windows.

Cet exemple illustre l'inscription d'une instance de Notification Services, crée le service Windows et fournit une authentification SQL Server que le service utilise pour la connexion à SQL Server. Notez que les services nécessitent à la fois un compte et un mot de passe SQL Server, ainsi qu'un compte et un mot de passe Windows. Le service utilise les autorisations Windows pour le démarrage des ressources autres que bases de données et l'accès à celles-ci. Il emploie aussi le compte SQL Server pour accéder aux bases de données.

nscontrol register -name StockInstance -server nsuetest -service 
    -serviceusername SvcAcct -servicepassword svC-P@sWd 
    -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.