nscontrol export (comando)

Actualizado: 5 de diciembre de 2005

Crea un archivo de configuración de instancia (ICF) XML y uno o más archivos de definición de aplicación (ADF) XML (uno por aplicación) exportando los metadatos de las bases de datos. Los archivos resultantes son definiciones válidas de la instancia y las aplicaciones en el momento en que se ejecuta el comando de exportación. Puede usar esta información para realizar una copia de seguridad de la instancia y de las definiciones de la aplicación o para generar archivos que puede usar para crear o actualizar la instancia.

Sintaxis

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

Argumentos

• -nologo
  Suprime la instrucción de producto y versión que aparece al ejecutar un comando nscontrol.

• -help
  Muestra la sintaxis del comando.

• -nameinstanceName
  Es el nombre de la instancia de la que se crean los archivos de definición de aplicación y configuración.

• -serverdatabaseServer
  Es el nombre del servidor que aloja las bases de datos de la aplicación y de la instancia. Proporcione este argumento sólo si la instancia no está registrada en el equipo local. Si la instancia está registrada y proporciona el argumento -server, se omiten los valores de registro para la instancia.

  Si utiliza una instancia con nombre de SQL Server para alojar la base de datos de instancia, especifique el nombre del servidor y el nombre de instancia utilizando el formato <servername>\<instancename>.

• -sqlusernamesqlUserName
  Es el inicio de sesión de SQL Server que se utiliza para conectar con SQL Server.

  Importante:
  La autenticación de Windows es más segura que la autenticación de SQL Server. Siempre que sea posible, utilice la autenticación de Windows.

  Si utiliza la autenticación de SQL Server para conectar con SQL Server, especifique un inicio de sesión mediante este argumento. Especifique también una contraseña utilizando el argumento -sqlpassword.

  Si utiliza la autenticación de Windows, no especifique los argumentos -sqlusername y -sqlpassword.

• -sqlpasswordsqlPassword
  Es la contraseña asociada con el inicio de sesión -sqlusername. Este argumento sólo se debe utilizar cuando la conexión se lleva a cabo mediante la autenticación de SQL Server.

• -outdirectory
  Es el directorio en el que se guardan los archivos. El directorio predeterminado es el directorio actual.

• -force
  Especifica que se sobrescriban los archivos existentes del mismo nombre en el directorio de salida.

Notas

Puede usar el comando nscontrol export mientras se está ejecutando la instancia. No hace falta deshabilitar o detener la instancia.

El archivo de configuración resultante se denomina <instance_name>.config.xml. Cada ADF resultante se denomina <instance_name>.<application_name>.adf.xml.

El comando nscontrol export guarda los archivos usando la codificación UTF-8. Para exportar los archivos de definición de aplicación y configuración utilizando otras codificaciones, utilice el comando Exportar de SQL Server Management Studio.

El comando nscontrol export no crea los archivos de definición de aplicación y configuración originales. Crea archivos que contienen la configuración de la instancia y la aplicación actuales, incluyendo valores que pueden haber sido proporcionados mediante parámetros reemplazables. Por este motivo, recomendamos que conserve los archivos de definición de aplicación y configuración originales y que utilice nscontrol export si tiene que determinar la configuración de aplicación y de instancia actual.

El comando nscontrol export modifica los valores de ApplicationDefinitionFilePath en el archivo de configuración para que apunten a los archivos ADF exportados; esta ruta se modifica de tal modo que el archivo de configuración se pueda usar de forma inmediata. Todas las otras configuraciones de ruta, incluyendo BaseDirectoryPath, se dejan sin modificar porque pueden apuntar a otros archivos que necesita la instancia, como los archivos formateadores de contenido.

Permisos

La cuenta que se utiliza para ejecutar nscontrol export o el inicio de sesión de SQL Server especificado por el argumento -sqlusername pueden obtener permisos de base de datos mediante su pertenencia a la función de base de datos NSReader en cada base de datos de instancia y de aplicación individual. Los miembros de la función de base de datos db_owner y de las funciones fijas de servidor sysadmin y dbcreator también pueden ejecutar nscontrol export.

La cuenta también debe tener permiso para ejecutar los archivos binarios de Notification Services; este permiso se concede a miembros de los grupos de Windows Administradores y SQLServerNotificationServicesUser.

Ejemplos

El siguiente ejemplo ilustra cómo exportar metadatos a archivos XML.

A. Exportar archivos al directorio actual

Este ejemplo muestra cómo exportar información de aplicación y de instancia para la instancia de StockInstance. La utilidad nscontrol utiliza la autenticación de Windows para conectar con SQL Server y guarda los archivos de definición de aplicación y configuración en el directorio actual. Si ya existen los archivos, nscontrol muestra un mensaje de error.

nscontrol export -name StockInstance

B. Exportar archivos a un directorio específico, sobrescribiendo los archivos existentes

Este ejemplo muestra cómo especificar un directorio para los archivos de aplicación y de instancia resultantes. También muestra cómo utilizar el argumento –force para sobrescribir los archivos existentes que tengan el mismo nombre.

La utilidad nscontrol utiliza la autenticación de Windows para conectar con SQL Server.

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

C. Exportar archivos desde un equipo de administración

Este ejemplo muestra cómo exportar información de aplicación y de instancia cuando la instancia no esté registrada en el equipo. Debe especificar el nombre de instancia de SQL Server utilizando el argumento –server. Este ejemplo también especifica un directorio de salida y que se sobrescriban los archivos existentes que tengan el mismo nombre.

La utilidad nscontrol utiliza la autenticación de Windows para conectar con SQL Server.

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

D. Exportar archivos utilizando la autenticación de SQL Server

Este ejemplo muestra cómo exportar información de instancia para la instancia StockInstance utilizando la autenticación de SQL Server para conectar con SQL Server. Los archivos de definición de aplicación y de configuración se crean en el directorio C:\NS\Export, pero no se sobrescriben si ya existen.

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

Vea también

Referencia

nscontrol (utilidad)

Otros recursos

Cómo ver información de versión de Notification Services

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión	Historial
5 de diciembre de 2005	Contenido nuevo: Se agregó información acerca del grupo de Windows SQLServerNotificationServicesUser.