nscontrol disable (comando)

Actualizado: 5 de diciembre de 2005

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

Sintaxis

nscontrol disable 
    [-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>
  Representa el componente que debe deshabilitarse. Puede especificar cero o más componentes cuando ejecute nscontrol disable.

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

  <component> puede ser cualquiera de los argumentos siguientes:

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

• -nameinstanceName
  Especifica el nombre de la instancia afectada por nscontrol disable. Si especifica el argumento -name sin especificar el argumento -application o un componente, nscontrol deshabilita todos los componentes y las aplicaciones de la instancia.

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

• -serverdatabaseServer
  Especifica 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 disable 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 disable 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
  Especifica el nombre de la aplicación en la que se deshabilitan uno o más componentes. Si no especifica un nombre de aplicación, se deshabilitan los componentes para todas las aplicaciones que alberga la instancia.

• -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 el 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
  Especifica la contraseña asociada con el inicio de sesión -sqlusername. Este argumento se debe utilizar con el argumento -sqlusername.

Notas

El comando nscontrol disable cambia el estado de los componentes especificados a Deshabilitar 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 disable, Notification Services difunde el cambio de estado deseado a todos los componentes. El estado cambia de "Deshabilitar pendiente" a "Deshabilitado" después de que los componentes en ejecución hayan respondido al cambio. Con la excepción de los componentes de suscriptor y de suscripción, la instancia debe estar ejecutándose para que los estados del componente cambien de Deshabilitar pendiente a Deshabilitado. Sin embargo, el cambio de estado de Habilitar pendiente a Deshabilitado o 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 disable 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.

Si un motor (normalmente el servicio de Windows NS$instance_name) se inicia, determina dónde se está ejecutando (su nombre de 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 ejecuta en el servidor. Si un componente está deshabilitado, no se ejecuta.

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. Por lo tanto, si realiza un cambio en el estado de cualquiera de estos componentes, el cambio puede tardar 30 segundos en tener efecto.

El estado de los suscriptores y de las suscripciones se almacena en el 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 disable o el Id. de 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 disable.

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. Deshabilitar la instancia completa de Notification Services

El siguiente ejemplo deshabilita una instancia completa de Notification Services, denominada StockInstance. 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 disable -name StockInstance

B. Deshabilitar una sola aplicación

El siguiente ejemplo deshabilita todos los componentes de la aplicación Stock alojada por 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 disable -name StockInstance -application Stock

C. Deshabilitar todos los proveedores de eventos alojados

El siguiente ejemplo deshabilita toda la colección de eventos 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 disable -name StockInstance -events

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

Si ejecuta nscontrol disable 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 deshabilitar 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 disable -name StockInstance -server nsuetest

E. Deshabilitar una instancia mediante la autenticación de SQL Server

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

El siguiente ejemplo deshabilita una instancia completa de Notification Services denominada StockInstance. El comando nscontrol utiliza la autenticación de SQL Server para conectar con SQL Server. La instancia debe estar registrada en el equipo donde se ejecuta el comando.

nscontrol disable -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