Commande nscontrol export

Mis à jour : 5 décembre 2005

Crée un fichier de configuration d'instance (ICF) XML et un ou plusieurs fichiers de définition d'application (ADF) XML (un par application) en exportant les métadonnées à partir des bases de données. Les fichiers résultants constituent des définitions valides de l'instance et des applications au moment de l'exécution de la commande d'exportation. Vous pouvez utiliser ces informations pour sauvegarder vos définitions d'instance et d'application ou pour générer des fichiers que vous pouvez utiliser pour créer ou mettre à jour l'instance.

Syntaxe

nscontrol export 
    [-nologo]
    [-help] 
        -name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-out directory]
    [-force]

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 à partir de laquelle sont créés les fichiers de configuration et de définition d'application.

• -serverdatabaseServer
  Nom du serveur qui héberge les bases de données d'instance et d'application. Fournissez cet argument uniquement si l'instance n'est pas inscrite sur l'ordinateur local. Si l'instance est inscrite et que vous fournissez l'argument -server, les valeurs de Registre de l'instance ne sont pas prises en compte.

  Si vous utilisez une instance nommée de SQL Server pour héberger la base de données de l'instance, spécifiez le nom du serveur et le nom de l'instance en utilisant le format <servername>\<instancename>.

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

  Important :
  L'authentification Windows est plus sûre que l'authentification SQL Server. À chaque fois que possible, utilisez l'authentification Windows.

  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.

• -sqlpasswordsqlPassword
  Mot de passe associé au nom d'ouverture de session -sqlusername. Utilisez cet argument uniquement lorsque vous établissez une connexion avec l'authentification SQL Server.

• -outdirectory
  Répertoire dans lequel les fichiers sont écrits. Le répertoire par défaut est le répertoire actuel.

• -force
  Spécifie de remplacer les fichiers existants portant le même nom dans le répertoire de sortie.

Notes

Vous pouvez utiliser la commande nscontrol export pendant que l'instance est en cours d'exécution. Vous n'avez pas besoin de désactiver ou d'arrêter l'instance.

Le fichier de configuration résultant se nomme <instance_name>.config.xml. Chaque fichier ADF obtenu se nomme <instance_name>.<application_name>.adf.xml.

La commande nscontrol export écrit les fichiers en utilisant le codage UTF-8. Pour exporter les fichiers de configuration et de définition d'application en utilisant d'autres codages, utilisez la commande Export dans SQL Server Management Studio.

La commande nscontrol export ne recrée pas les fichiers de configuration et de définition d'application d'origine. Elle crée des fichiers qui contiennent l'instance et les paramètres d'application actuels, notamment les valeurs pouvant avoir été fournies par des paramètres remplaçables. Pour cette raison, nous vous recommandons de conserver les fichiers de configuration et de définition d'application d'origine et d'utiliser nscontrol export si vous souhaitez déterminer les paramètres d'instance et d'applications actuels.

La commande nscontrol export modifie les valeurs ApplicationDefinitionFilePath dans le fichier de configuration pour pointer vers les fichiers ADF exportés ; ce chemin est modifié afin que le fichier de configuration puisse être utilisé immédiatement. Tous les autres paramètres de chemin, notamment BaseDirectoryPath, sont laissés tels quels parce qu'ils peuvent pointer vers d'autres fichiers requis par l'instance, par exemple des fichiers de module de formatage de contenu.

Autorisations

Le compte utilisé pour exécuter nscontrol export, ou le nom d'ouverture de session SQL Server spécifié par l'argument -sqlusername, peuvent obtenir les autorisations de base de données en tant que membre du rôle de base de données NSReader 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 fixes sysadmin et dbcreator peuvent aussi exécuter nscontrol export.

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 l'exportation de métadonnées dans des fichiers XML.

A. Exportation de fichiers dans le répertoire actuel

Cet exemple illustre l'exportation d'informations d'instance et d'application pour l'instance StockInstance. L'utilitaire nscontrol emploie l'authentification Windows pour la connexion à SQL Server et écrit les fichiers de configuration et de définition d'application dans le répertoire actuel. Si les fichiers existent déjà, nscontrol affiche un message d'erreur.

nscontrol export -name StockInstance

B. Exportation de fichiers dans un répertoire spécifique, en remplaçant les fichiers existants

Cet exemple montre comment spécifier un répertoire pour les fichiers d'instance et d'application résultants. Il illustre également l'utilisation de l'argument –force pour remplacer des fichiers existants de même nom.

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

nscontrol export -name StockInstance -out "C:\NS\Export" -force

C. Exportation de fichiers à partir d'un ordinateur d'administration

Cet exemple illustre l'exportation des informations d'instance et d'application lorsque l'instance n'est pas inscrite sur l'ordinateur. Vous devez spécifier le nom d'instance de SQL Server en utilisant l'argument –server. Cet exemple spécifie également un répertoire de sortie et prévoit le remplacement des fichiers existants de même nom.

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

nscontrol export -name StockInstance -server nsuetest 
    -out "C:\NS\Export" -force

D. Exportation de fichiers en utilisant l'authentification SQL Server

Cet exemple illustre l'exportation d'informations d'instance pour l'instance StockInstance à l'aide de l'authentification SQL Server pour la connexion à SQL Server. Les fichiers de configuration et de définition d'application sont créés dans le répertoire C:\NS\Export, mais ne sont pas écrasés s'ils existent déjà.

nscontrol export -name StockInstance -out "C:\NS\Export" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd 

Voir aussi

Référence

Utilitaire nscontrol

Autres ressources

Procédure : afficher les informations sur la version de 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.