nscontrol register (comando)

Actualizado: 5 de diciembre de 2005

Crea o actualiza entradas de registro para una instancia de Notification Services, crea contadores de rendimiento para la instancia y, opcionalmente, crea un servicio de Microsoft Windows para ejecutar la instancia.

Sintaxis

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

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 que se va a registrar.

• -serverdatabaseServer
  Es el nombre del servidor que aloja la base de datos de instancia. Si utiliza una instancia con nombre de SQL Server para alojar la base de datos de instancia, debe especificar tanto el nombre de servidor como el nombre de la instancia utilizando el formato <nombreDeServidor>\<nombreDeInstancia>. Si no especifica un nombre de servidor de base de datos, nscontrol register utiliza el nombre de servidor local.

• -service
  Crea un servicio de Windows NS$instance_name que controla la instancia de Notification Services en el servidor.

  Normalmente se utiliza el argumento -server en cualquier servidor que ejecute un generador, distribuidor o proveedor de eventos alojados. Este argumento no se utiliza en servidores que sólo ejecutan interfaces de administración de suscripciones, proveedores de eventos no alojados o aplicaciones de administración.

  Si está alojando el motor Notification Services en su aplicación, no utilice el argumento -service. Para obtener más información acerca del alojamiento del motor, vea Alojar el motor de Notification Services.

• -serviceusernameNSServiceUserName
  Es la cuenta de Windows que el servicio de Windows utiliza para tener acceso a recursos locales y remotos. Si utiliza la autenticación de Windows, el servicio de Windows también utiliza esta cuenta para iniciar sesión en SQL Server y tener acceso a las bases de datos de instancia y aplicación.

  Para las cuentas locales y de dominio, debe usarse este argumento junto con el argumento -servicepassword. Las cuentas integradas como NetworkService no tienen contraseñas.

  En Microsoft Windows® XP, si no se especifican -serviceusername y -servicepassword, se utiliza la cuenta predeterminada NT AUTHORITY\NetworkService. Para otros sistemas operativos, se necesita -serviceusername y -servicepassword.

  [!NOTA] Por motivos de seguridad, la cuenta de servicio debería ejecutarse con permisos mínimos y no como un administrador ni como la cuenta de servicio LocalSystem. Para obtener más información, vea Configurar cuentas de Windows para una instancia de Notification Services.

  Si utiliza la autenticación de Windows, esta cuenta debe tener permisos en las bases de datos de aplicación y de instancia. Para obtener más información, vea Configurar permisos de SQL Server para una instancia de Notification Services.

• -servicepasswordNSServicePwd
  Es la contraseña asociada con -serviceusername. Este argumento debe utilizarse con el argumento -serviceusername.

• -sqlusernameNSServiceSqlUserName
  Es el inicio de sesión de SQL Server que utiliza el servicio de Windows NS$<instance_name> para conectar con SQL Server.

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

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

  [!NOTA] Si asigna un nombre de usuario y una contraseña de SQL Server al servicio, esta información se cifra y almacena en el Registro. Para evitar el almacenamiento de esta información, utilice la autenticación de Windows.

• -sqlpasswordNSServiceSqlPwd
  Es la contraseña asociada con el inicio de sesión -sqlusername. Este argumento se debe utilizar con el argumento -sqlusername.

• -argumentkeykey
  Es el valor utilizado 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 sólo se utiliza si se especifica el argumento –service; de lo contrario, se omite la clave.

  Si registra la instancia utilizando una clave de cifrado, debe usar la misma clave cuando cree y actualice la instancia. Para ello, el valor de EncryptArguments del archivo de configuración debe ser true.

  La clave es una cadena de hasta 2.500 caracteres. nscontrol register cifra el valor de la clave y lo almacena en el Registro; esto es necesario para permitir al servicio de Windows NS$instance_name leer los argumentos cifrados.

  No se puede cambiar la clave tras crear la instancia, que se crea con el comando nscontrol create o Nueva instancia de Notification Services en SQL Server Management Studio.

Notas

El comando nscontrol register debe ejecutarse localmente. No es posible registrar Notification Services en un servidor remoto.

Si utiliza la autenticación de SQL Server para conectar con SQL Server, y si debe actualizar el nombre de usuario de SQL Server o la contraseña utilizada por el servicio, debe cambiar la información de inicio de sesión utilizando nscontrol register o el cuadro de diálogo Registrar para Notification Services en SQL Server Management Studio. Notification Services cifra el nombre de usuario y la contraseña y los almacena en el Registro, al que sólo los administradores y el servicio de Windows tienen acceso.

Si especifica un valor de clave de cifrado utilizando -argumentkey, el comando nscontrol register cifra la clave y la almacena en el Registro. La clave se protege para que sólo los miembros del grupo local Administradores y la cuenta en la que se ejecuta el servicio NS$instance_name puedan leerla.

Permisos

La cuenta utilizada para ejecutar nscontrol register 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. Si crea un servicio de Windows y contadores de rendimiento, la cuenta debe ser miembro del grupo Administradores.

Para obtener información acerca de los permisos que necesita el servicio de Windows NS$instance_name para Notification Services, vea Proteger Notification Services.

Ejemplos

En los ejemplos siguientes, se muestran tres formas distintas de registrar una instancia.

A. Registrar una instancia y crear un servicio de Windows

Este ejemplo muestra cómo registrar una instancia denominada StockInstance utilizando la autenticación de Windows para conectar con SQL Server. Si registra la instancia utilizando los siguientes argumentos, se crea un servicio de Windows para la instancia, se define el nombre de usuario y la contraseña que utiliza el servicio de Windows para tener acceso a SQL Server (y para iniciar recursos de Windows y tener acceso a ellos), y se proporciona el nombre de la instancia de SQL Server que aloja las bases de datos.

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

B. Registrar una instancia sin crear un servicio de Windows

Este ejemplo muestra cómo registrar una instancia denominada StockInstance en los siguientes escenarios:

• El servidor tiene una interfaz de administración de suscripción o un proveedor de eventos independientes, pero el servidor no ejecuta un proveedor de eventos alojados, un generador ni un distribuidor.
• El motor de Notification Services que ejecuta los proveedores de eventos alojados, los generadores y los distribuidores se aloja en una aplicación personalizada, de forma que el servicio de Windows no es necesario.

En estos escenarios, debe registrar la instancia para que los componentes de la instancia puedan ubicar las bases de datos, pero no utilice el argumento -server para crear el servicio de Windows.

También puede utilizar este ejemplo para actualizar el nombre del servidor de base de datos en una entrada de Registro existente.

nscontrol register -name StockInstance -server nsuetest

C. Autenticación de SQL Server

Importante:
Siempre que sea posible, utilice la autenticación de Windows.

Este ejemplo muestra cómo registrar una instancia de Notification Services, crear el servicio de Windows y proporcionar una autenticación de SQL Server que utilice el servicio para conectar con SQL Server. Tenga en cuenta que el servicio requiere una cuenta y una contraseña de SQL Server, así como una cuenta y una contraseña de Windows. El servicio utiliza los permisos de Windows para iniciarse y para tener acceso a recursos que no son de la base de datos, y utiliza la cuenta de SQL Server para tener acceso a las bases de datos.

nscontrol register -name StockInstance -server nsuetest -service 
    -serviceusername SvcAcct -servicepassword svC-P@sWd 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

Vea también

Referencia

nscontrol (utilidad)

Otros recursos

Implementar una instancia de Notification Services
Actualizar la información del Registro
EncryptArguments Element (ICF)
Alojar el motor de Notification Services

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios