nscontrol enable (comando)

Actualizado: 5 de diciembre de 2005

Habilita el componente, la aplicación o la instancia de SQL Server Notification Services que se ha especificado.

Sintaxis

nscontrol enable 
    [-nologo]
    [-help]
    [< component > [...n]]
        -name instanceName
    [-server databaseServer]
    [-application applicationName]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]

< component > ::=
    -events [systemName]
    | -generator
    | -distributor [ systemName ]
    | -subscriptions
    | -subscribers 

Argumentos

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

• -help
  Muestra la sintaxis del comando.

• < component >
  Especifica un componente que se va a habilitar. Puede especificar cero o más componentes cuando ejecute nscontrol enable.

  Si no se especifica un nombre de componente, se habilitan todos los componentes de la instancia o la aplicación. Si especifica un componente pero no un nombre de aplicación mediante el argumento -application, se habilitan todos los componentes coincidentes de todas las aplicaciones que alberga la instancia.

  < component> puede ser cualquiera de los argumentos siguientes:

  Argumento	Descripción
  -distributor [systemName]	Habilita la distribución para la instancia o la aplicación. Si se especifica un nombre de sistema de distribuidor, sólo se habilitan los distribuidores en ese sistema. En caso contrario, se habilitan todos los distribuidores para la instancia o la aplicación.
  -events [systemName]	Habilita los proveedores de eventos alojados para la instancia o aplicación. Si se especifica -events con un nombre de sistema, sólo se habilitan los proveedores de eventos alojados en ese sistema. En caso contrario, se habilitan todos los proveedores de eventos alojados para la instancia o la aplicación.
  -generator	Habilita el generador.
  -subscriptions	Habilita la administración de suscripciones.
  -subscribers	Habilita la administración de suscriptores para la instancia de Notification Services.

• -nameinstanceName
  Es el nombre de la instancia afectada por nscontrol enable. Si especifica el argumento –name sin especificar el argumento –application o un componente, la utilidad nscontrol habilita todos los componentes o las instancias de las aplicaciones.

  Vea el argumento -server para obtener información sobre cómo utilizar el argumento -name con el argumento -server.

• -serverdatabaseServer
  Es el nombre del servidor que aloja las bases de datos de la aplicación y de la instancia. Si utiliza una instancia con nombre de SQL Server para alojar las bases de datos, debe especificar el nombre del servidor y el nombre de la instancia utilizando el formato <nombreDeServidor>\<nombreDeInstancia>.

  Si ejecuta nscontrol enable en un sistema en el que la instancia se ha registrado anteriormente utilizando el comando nscontrol register, utilice el argumento -name pero sin el argumento -server. La utilidad nscontrol determina el nombre de la instancia de SQL Server leyendo la información de registro de la instancia.

  Si ejecuta nscontrol enable en un sistema en el que la instancia no está registrada, debe usar los argumentos -name y -server, ya que la utilidad nscontrol necesita el nombre de la instancia de Notification Services y el nombre de la instancia de SQL Server para localizar la base de datos de instancias.

  Si especifica el argumento -server, la utilidad nscontrol omite los valores de registro de la instancia.

• -applicationapplicationName
  Es el nombre de la aplicación para la que se habilitan uno o todos los componentes. Si no especifica un nombre de aplicación, los componentes especificados se habilitan para todas las aplicaciones alojadas por la instancia.

• -sqlusernamesqlUserName
  Es 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 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.

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

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

Notas

El comando nscontrol enable cambia el estado de los componentes especificados a Habilitar pendiente actualizando un valor de una base de datos. El estado de la instancia se almacena en la base de datos de instancia. El estado del componente individual se almacena en la base de datos de aplicación.

Si ejecuta nscontrol enable, Notification Services difunde el cambio de estado deseado a todos los componentes. El estado cambia de Habilitar pendiente a Habilitado después de que los componentes en ejecución hayan respondido al cambio. Con la excepción de los componentes de suscripción y suscriptor, el motor (normalmente, el servicio de Windows NS$instance_name) debe estar ejecutándose para que los estados de componentes cambien de Habilitar pendiente a Habilitado. Sin embargo, el cambio de estado de Habilitar pendiente a Deshabilitado o de Deshabilitar pendiente a Habilitado no requiere que el servicio se esté ejecutando, ya que esas acciones simplemente cancelan una operación pendiente.

Después de que nscontrol enable modifique la base de datos, mostrará el estado actual de la instancia, las aplicaciones y los componentes. Para ver descripciones de los valores de los estados, vea Ver el estado de instancias, aplicaciones y componentes.

Cuando se inicia un servicio de NS$<instance_name>, determina dónde se ejecuta (el nombre de su host) y después compara este valor con el valor de SystemName para cada distribuidor, proveedor de eventos alojado y generador. Si el nombre de host coincide con el valor de SystemName, el servicio comprueba el estado del componente. Si el componente está habilitado, se inicia.

Mientras se ejecuta el servicio, comprueba la base de datos cada 30 segundos para determinar el estado de los proveedores de eventos alojados, el generador y los distribuidores.

El estado de los suscriptores y de las suscripciones se almacena en la caché del servidor de la base de datos y los objetos de administración de suscripciones comprueban este estado antes de realizar operaciones en la suscripción o el suscriptor.

Permisos

La cuenta que se utiliza para ejecutar nscontrol enable o el inicio de sesión de SQL Server especificado por el argumento -sqlusername puede obtener los permisos adecuados mediante su pertenencia a la función de base de datos NSAdmin en cada base de datos de aplicación y de instancia 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 enable.

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

A. Habilitar una instancia de Notification Services

El siguiente ejemplo habilita una instancia completa de Notification Services denominada StockInstance. La instancia debe estar registrada en el equipo en que se ejecuta el siguiente comando.

nscontrol enable -name StockInstance

B. Habilitar una sola aplicación

El siguiente ejemplo habilita todos los componentes de la aplicación Stock de la instancia StockInstance de Notification Services. El comando nscontrol utiliza la autenticación de Windows para conectar con SQL Server. La instancia debe estar registrada en el equipo donde se ejecuta el comando.

nscontrol enable -name StockInstance -application Stock

C. Habilitar todos los proveedores de eventos alojados

El siguiente ejemplo habilita los proveedores de eventos alojados para todas las aplicaciones de la instancia StockInstance de Notification Services. El comando nscontrol**** utiliza la autenticación de Windows para conectar con SQL Server. La instancia debe estar registrada en el equipo donde se ejecuta el comando.

nscontrol enable -name StockInstance -events

D. Habilitar una instancia desde un equipo de administración

Si ejecuta nscontrol enable desde un equipo en el que StockInstance no está registrada, debe proporcionar el nombre de instancia de SQL Server utilizando el argumento -server. El siguiente ejemplo muestra cómo habilitar una instancia cuando las bases de datos están en una instancia de SQL Server denominada nsuetest. El comando nscontrol**** utiliza la autenticación de Windows para conectar con SQL Server.

nscontrol enable -name StockInstance -server nsuetest

E. Utilizar la Autenticación de SQL Server para habilitar una instancia de Notification Services

El siguiente ejemplo habilita toda una instancia de Notification Services denominada StockInstance, utilizando la autenticación de SQL Server para conectar con SQL Server. La instancia debe estar registrada en el equipo en que se ejecuta el siguiente comando.

nscontrol enable -name StockInstance -sqlusername SqlUser 
    -sqlpassword sQl-P@sWd

Vea también

Referencia

nscontrol (utilidad)

Otros recursos

Habilitar y deshabilitar instancias, aplicaciones o componentes

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios