nscontrol create (comando)

Actualizado: 5 de diciembre de 2005

Crea una nueva instancia de Microsoft SQL Server Notification Services.

Sintaxis

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

Argumentos

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

• -help
  Muestra la sintaxis del comando.

• -inconfigFile
  Especifica la ruta de acceso y el nombre del archivo de configuración de instancia (ICF) que define la instancia. Si el archivo está en el directorio actual, no se requiere la ruta de acceso.

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

  Si utiliza la autenticación de SQL Server para conectar con SQL Server, especifique un Id. de inicio de sesión mediante este argumento. Este argumento se debe utilizar con el argumento -sqlpassword.

  Si utiliza la autenticación de Windows para conectar con SQL Server, no utilice los argumentos -sqlusername y -sqlpassword.

  [!NOTA] Siempre que sea posible, utilice la autenticación de Windows.

• -sqlpasswordsqlPassword
  Especifica la contraseña asociada al Id. de inicio de sesión -sqlusername. El argumento debe usarse junto con el argumento -sqlusername.

• -argumentkeykey
  Especifica la clave utilizada para cifrar los argumentos del canal de entrega y del proveedor de eventos que se almacenan en las bases de datos de Notification Services. La clave es una cadena de hasta 2.500 caracteres.

  Este argumento es necesario si el valor de EncryptArguments en el archivo de configuración es true. No puede cambiar el valor de la clave utilizada por la instancia tras ejecutar el comando nscontrol create. Para utilizar una clave diferente, debe eliminar y volver a crear la instancia.

  También debe especificar el mismo valor de clave cuando ejecute el comando nscontrol register y el comando nscontrol update. El comando nscontrol register cifra el valor de la clave y lo almacena en el registro.

• param=value
  Es un par nombre/valor que se utiliza para pasar valores de parámetros al ICF desde el símbolo del sistema.

  Cualquier cadena que aparezca entre los caracteres de signo de porcentaje (%) del ICF es un parámetro reemplazable. Si el ICF contiene parámetros reemplazables (como DBSystem en el siguiente ejemplo), especifique el nombre y el valor del parámetro en la línea de comandos (o en la sección ParameterDefaults del ICF). Por ejemplo, si el archivo de configuración contiene el código XML siguiente:

  <SqlServerSystem>%DBSystem%</SqlServerSystem>
  

  Puede especificar el nombre y el valor utilizando nscontrol create de la siguiente manera:

  nscontrol create -in config.xml DBSystem=MySQLServer
  

  Los valores de parámetro que proporcione en el símbolo del sistema se aplican a parámetros del ICF, pero no directamente a los parámetros de los archivos de definición de aplicación (ADF). Para pasar valores del parámetro a un ADF, agregue una subsección Parameters a la sección Application del ICF. Puede utilizar parámetros reemplazables y proporcionar valores para esos parámetros en el símbolo del sistema.

  Además de especificar parámetros en el símbolo del sistema, puede utilizar variables de entorno como, por ejemplo, %COMPUTERNAME%, en el ICF. Si utiliza una variable de entorno en el ICF, tenga en cuenta que un par de valor/nombre del símbolo del sistema del mismo nombre prevalece sobre la variable de entorno.

Notas

El comando nscontrol create valida el ICF y los ADF comparándolos con sus esquemas XML y comprueba si hay valores no permitidos, como el valor true para una entrega multidifusión y una entrega de resumen. Si la validación o las comprobaciones no son correctas, nscontrol create se detiene sin crear la instancia.

El comando nscontrol create activa las cadenas de propiedad entre bases de datos en las bases de datos de la aplicación y de la instancia. Estas bases de datos requieren las cadenas de propiedad entre bases de datos para permitir que los procedimientos almacenados de Notification Services tengan acceso a objetos de las bases de datos de la aplicación y de la instancia.

Si utiliza Notification Services Standard Edition y no se permiten en esta versión uno o varios elementos, nscontrol create se detiene sin crear la instancia. Para obtener más información sobre Notification Services Standard Edition, vea Versiones de Notification Services.

Puede ejecutar nscontrol create desde cualquier equipo que tenga los componentes de cliente de Notification Services instalados y que no tenga acceso al motor de la base de datos SQL Server que almacenará los metadatos de la aplicación y de la instancia.

Para poder ejecutar la instancia de Notification Services, debe registrar la instancia utilizando nscontrol register. El proceso de registro crea una entrada de Registro y, opcionalmente, crea un servicio de Windows que sirve para ejecutar la instancia.

No puede usar nscontrol create para actualizar una instancia. En su lugar, utilice nscontrol update.

Permisos

La cuenta que se utiliza para ejecutar nscontrol create, o el inicio de sesión de SQL Server que se especifica en el argumento -sqlusername, debe ser miembro de la función fija de servidor sysadmin. 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

Los siguientes ejemplos muestran cómo crear una instancia de Notification Services.

A. Ejemplo básico

Este ejemplo muestra cómo crear una nueva instancia de Notification Services utilizando InstanceConfig.xml de ICF y conectar con SQL Server mediante la autenticación de Windows.

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

B. Proporcionar valores para parámetros de archivos de configuración

Este ejemplo muestra cómo pasar valores a los parámetros BaseDirectoryPath, NSHost y SqlServer del ICF. El comando nscontrol conecta con SQL Server mediante la autenticación de Windows.

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

C. Proporcionar una clave de cifrado de argumentos

Este ejemplo muestra cómo proporcionar una clave de cifrado de argumentos cuando se crea la instancia. Tenga en cuenta que la clave debe coincidir con la clave que se utiliza cuando se registra la instancia.

El comando nscontrol conecta con SQL Server mediante la autenticación de Windows.

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

D. Usar la autenticación de SQL Server

Este ejemplo muestra cómo crear una nueva instancia de Notification Services mediante la autenticación de SQL Server para conectar con SQL Server.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

Vea también

Referencia

nscontrol (utilidad)

Otros recursos

EncryptArguments Element (ICF)
Implementar una instancia de Notification Services

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios