Commande nscontrol create

Article
12/15/2008

Mis à jour : 5 décembre 2005

Crée une nouvelle instance de Microsoft SQL Server Notification Services.

Syntaxe

nscontrol create 
    [-nologo]
    [-help]
        -in configFile
    [-sqlusername sqlUserName  -sqlpassword sqlPassword]
    [-argumentkey key]
    [param=value ...]

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.

-inconfigFile
Spécifie le chemin d'accès et le nom du fichier de configuration d'instance (ICF) qui définit l'instance. Si ce fichier se trouve dans le répertoire actif, le chemin n'est pas nécessaire.

-sqlusernamesqlUserName
Spécifie le 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 l'ID de connexion avec cet argument. Cet argument doit être utilisé avec l'argument -sqlpassword.

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

Remarque :

Utilisez si possible l'authentification Windows.

Remarque :
Utilisez si possible l'authentification Windows.

-sqlpasswordsqlPassword
Spécifie le mot de passe associé à l'ID de connexion -sqlusername. Cet argument doit être utilisé conjointement à l'argument -sqlusername.

-argumentkeykey
Spécifie la clé 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 une chaîne comportant jusqu'à 2 500 caractères.

Cet argument est nécessaire si la valeur EncryptArguments du fichier de configuration est true. Vous ne pouvez pas modifier la valeur de clé utilisée par l'instance après l'exécution de la commande nscontrol create. Pour utiliser une autre clé, vous devez supprimer l'instance, puis la créer de nouveau.

Vous devez également spécifier la même valeur de clé lors de l'exécution de la commande nscontrol register et de la commande nscontrol update. La commande nscontrol register chiffre la valeur de clé et la stocke dans le Registre.

param=value
Paire nom/valeur utilisée pour passer des valeurs de paramètres au fichier ICF depuis la ligne de commande.

Toute chaîne apparaissant entre les caractères pour cent (%) dans le fichier ICF constitue un paramètre remplaçable. Si le fichier ICF contient des paramètres remplaçables (tels que DBSystem dans l'exemple suivant), spécifiez le nom et la valeur du paramètre sur la ligne de commande (ou dans la section ParameterDefaults du fichier ICF). Par exemple, si le fichier de configuration contient le code XML suivant :
```
<SqlServerSystem>%DBSystem%</SqlServerSystem>
```
Spécifiez ensuite le nom et la valeur avec nscontrol create de la façon suivante :
```
nscontrol create -in config.xml DBSystem=MySQLServer
```
Les valeurs de paramètres que vous fournissez au niveau de l'invite de commandes s'appliquent aux paramètres du fichier ICF, mais pas directement aux paramètres des fichiers de définition d'application (ADF). Pour passer des valeurs de paramètres à un fichier ADF, ajoutez une sous-section Parameters à la section Application du fichier ICF. Vous pouvez utiliser des paramètres remplaçables et fournir des valeurs pour ces paramètres au niveau de l'invite de commandes.

Vous pouvez non seulement spécifier des paramètres au niveau de l'invite de commandes, mais aussi utiliser des variables d'environnement telles que %COMPUTERNAME% dans le fichier ICF. Si vous utilisez une variable d'environnement dans le fichier ICF, notez qu'une paire nom/valeur du même nom est prioritaire par rapport à la variable d'environnement.

Notes

La commande nscontrol create valide le fichier ICF et les fichiers ADF par rapport à leurs schémas XML et vérifie l'absence de valeurs non valides, telles qu'une valeur true pour une remise par multidiffusion et une remise de type digest. Si la validation ou les contrôles ne passent pas, nscontrol create s'arrête sans créer l'instance.

La commande nscontrol create active le chaînage de propriété dans les bases de données d'instance et d'application. Ces bases de données nécessitent un chaînage de propriété entre bases de données pour permettre aux procédures stockées Notification Services d'accéder aux objets des bases de données d'instance et d'application.

Si vous utilisez Notification Services Standard Edition et qu'un ou plusieurs éléments ne sont pas pris en charge par cette édition, nscontrol create s'arrête sans créer l'instance. Pour plus d'informations sur Notification Services Standard Edition, consultez Éditions de Notifications Services.

Vous pouvez exécuter nscontrol create à partir d'un ordinateur sur lequel les clients Notification Services sont installés et qui dispose d'un accès au moteur de base de données de SQL Server qui stockera les métadonnées d'instance et d'application.

Avant d'exécuter l'instance de Notification Services, vous devez inscrire l'instance à l'aide de nscontrol register. L'inscription crée une entrée de Registre et, le cas échéant, un service Windows que vous pouvez utiliser pour exécuter l'instance.

Vous ne pouvez pas utiliser nscontrol create pour mettre à jour une instance. Utilisez plutôt nscontrol update.

Autorisations

Le compte que vous utilisez pour exécuter nscontrol create, ou la connexion SQL Server que vous spécifiez dans l'argument -sqlusername, doit être membre 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 création d'une instance de Notification Services.

A. Exemple de base

Cet exemple illustre la création d'une instance de Notification Services avec le fichier ICF InstanceConfig.xml et la connexion à SQL Server avec l'authentification Windows.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml"

B. Fourniture de valeurs pour des paramètres du fichier de configuration

Cet exemple illustre le passage de valeurs aux paramètres BaseDirectoryPath, NSHost et SqlServer dans le fichier ICF. La commande nscontrol établit une connexion à SQL Server avec l'authentification Windows.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    BaseDirectoryPath=C:\NS\Samples\Stock 
    NSHost=nsuetest SqlServer=nsuetest

C. Fourniture d'une clé de chiffrement d'argument

Cet exemple illustre la fourniture d'une clé de chiffrement d'argument lors de la création de l'instance. Notez que la clé doit correspondre à celle utilisée lors de l'inscription de l'instance.

La commande nscontrol établit une connexion à SQL Server avec l'authentification Windows.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -argumentkey "MyArgumentKey"

D. Utilisation de l'authentification SQL Server

Cet exemple illustre la création d'une instance de Notification Services en utilisant l'authentification SQL Server pour la connexion à SQL Server.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -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.