nscontrol enable, команда

Статья
12/15/2008

Изменения: 5 декабря 2005 г.

Включает указанный экземпляр служб SQL Server Notification Services, приложение или компонент.

Синтаксис

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

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

Аргументы

-nologo
Блокирует вывод на экран сведений о продукте и его версии, отображаемых при выполнении команды nscontrol.

-help
Отображает синтаксис команды.

< компонент >
Указывает включаемый компонент. При выполнении команды nscontrol enable можно указать ноль или положительное количество компонентов.

Если имя компонента не указано, то включаются все компоненты экземпляра или приложения. Если указано имя компонента, но не указано имя приложения с помощью аргумента -application, то включаются все совпадающие компоненты во всех приложениях экземпляра.

<компонент> может быть любым из следующих аргументов.

Аргумент	Описание
-distributor [systemName]	Включает распространение экземпляра или приложения. Если указано имя системы распространителя, то включаются только распространители в этой системе. В противном случае включаются все распространители экземпляра или приложения.
-events [systemName]	Включает внутрипроцессные поставщики событий экземпляра или приложения. Если параметр -events указывается с именем системы, то внутрипроцессные поставщики событий включаются только в этой системе. В противном случае включаются все внутрипроцессные поставщики событий экземпляра или приложения.
-generator	Включает генератор.
-subscriptions	Включает управление подпиской.
-subscribers	Включает управление подписчиками для экземпляра служб Notification Services.

-nameinstanceName
Имя экземпляра, на который влияет команда nscontrol enable. Если аргумент –name указан без параметра -application или задания компонента, то программа nscontrol включает все экземпляры и компоненты приложения.

Сведения об использовании аргумента -name с аргументом -server см. в описании аргумента -server.

-serverdatabaseServer
Имя сервера, на котором размещены базы данных экземпляров и приложений. Если для размещения баз данных используется именованный экземпляр служб SQL Server, необходимо указать имя сервера и имя экземпляра в формате <имя_сервера>\<имя_экземпляра>.

При запуске команды nscontrol enable в системе, где экземпляр был ранее зарегистрирован с помощью команды nscontrol register, используйте аргумент -name, а не аргумент -server. Программа nscontrol определяет имя экземпляра SQL Server, считывая сведения об экземпляре из реестра.

Если запуск программы nscontrol enable выполняется в системе, где экземпляр не зарегистрирован, необходимо использовать оба аргумента -name и -server, поскольку программе nscontrol необходимо как имя экземпляра Notification Services, так и имя экземпляра SQL Server.

Если указан аргумент -server, программа nscontrol не учитывает значения реестра для экземпляра.

-applicationapplicationName
Имя приложения, для которого включается один или все компоненты. Если не указано имя приложения, то указанные компоненты включаются для всех приложений экземпляра.

-sqlusernamesqlUserName
Является именем входа SQL Server, используемым для соединения с SQL Server.

Если для соединения с SQL Server используется проверка подлинности SQL Server, укажите в этом аргументе имя входа. Также укажите пароль с помощью аргумента -sqlpassword .

При использовании проверки подлинности Windows не указывайте аргументы -sqlusername и -sqlpassword.

Важно!

При возможности используйте проверку подлинности Windows.

Важно!
При возможности используйте проверку подлинности Windows.

-sqlpasswordsqlPassword
Пароль для имени входа -sqlusername. Этот аргумент должен использоваться вместе с аргументом -sqlusername.

Замечания

Команда nscontrol enable изменяет состояние указанных компонентов на «Ожидание включения», обновляя значения в базе данных. Состояние экземпляра хранится в базе данных экземпляра. Состояние отдельных компонентов хранится в базе данных приложений.

При запуске программы nscontrol enable, службы Notification Services рассылают желаемое изменение состояния всем компонентам. Изменение состояния с «Ожидание включения» на «Включен» происходит после получения ответа от всех работающих компонентов. За исключением компонентов подписчика и подписки, для изменения состояния компонентов с «Ожидание включения» на «Включено» должно быть запущено ядро (обычно это служба Windows NS$instance_name). Однако изменение состояния «Ожидание включения» на «Отключен» или «Ожидание отключения» на «Включен» не требует запуска службы, так эти такие действия просто отменяют отложенную операцию.

После того как программа nscontrol enable изменит базу данных, отобразится текущее состояние экземпляра, приложений и компонентов. Описание значений состояния см. в разделе Просмотр состояния экземпляров, приложений и компонентов.

При запуске служба NS$<имя_экземпляра> определяет имя узла, на котором она работает, а затем сравнивает это значение со значением SystemName для каждого распространителя, внутрипроцессного поставщика событий и генератора. Если имя узла совпадает со значением SystemName, то служба проверяет состояние компонента. Если компонент включен, он запускается.

Во время работы службы выполняется проверка базы данных каждые 30 секунд, чтобы определить состояние внутрипроцессные поставщики событий, генератора и распространителей.

Состояние подписчиков и подписок кэшируется на сервере базы данных, и управляющие объекты подписки проверяют это состояние перед выполнением операций подписчика или подписки.

Разрешения

Учетная запись, используемая для запуска программы nscontrol enable, или имя входа SQL Server, указанное аргументом -sqlusername, могут получить необходимые разрешения через членство в роли базы данных NSAdmin в отдельных базах данных приложений и экземпляра. Члены роли базы данных db_owner и фиксированных серверных ролей sysadmin и dbcreator также могут запустить команду nscontrol enable.

Эта учетная запись должна иметь разрешение на выполнение двоичных файлов Notification Services; такое разрешение предоставляется членам групп Windows «Администраторы» и SQLServerNotificationServicesUser.

Примеры

A. Включение экземпляра служб Notification Services

Следующий пример включает весь экземпляр служб Notification Services с именем StockInstance. Экземпляр должен быть зарегистрирован на компьютере, на котором запускается следующая команда.

nscontrol enable -name StockInstance

Б. Включение одного приложения

Следующий пример включает все компоненты приложения Stock на экземпляре StockInstance служб Notification Services. Команда nscontrol использует проверку подлинности Windows для соединения с службам SQL Server. Экземпляр должен быть зарегистрирован на компьютере, где выполняется команда.

nscontrol enable -name StockInstance -application Stock

В. Включение всех внутрипроцессных поставщиков событий

Следующий пример включает внутрипроцессные поставщики событий для всех приложений экземпляра StockInstance Notification Services. Команда nscontrol****использует проверку подлинности Windows для соединения с службам SQL Server. Экземпляр должен быть зарегистрирован на компьютере, где выполняется команда.

nscontrol enable -name StockInstance -events

Г. Включение экземпляра с административного компьютера

Если команда nscontrol enable запускается с компьютера, на котором экземпляр StockInstance не зарегистрирован, необходимо указать имя экземпляра SQL Server, используя аргумент -server . Следующий пример показывает, как включить экземпляр, если базы данных находятся в экземпляре SQL Server с именем nsuetest. Команда nscontrol использует проверку подлинности Windows для соединения со службами SQL Server.

nscontrol enable -name StockInstance -server nsuetest

Д. Использование проверки подлинности SQL Server для включения экземпляра служб Notification Services

Следующий пример включает весь экземпляр служб Notification Services с именем StockInstance, используя проверку подлинности SQL Server для соединения с SQL Server. Экземпляр должен быть зарегистрирован на компьютере, на котором запускается следующая команда.

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

См. также

Журнал изменений

Версия	Журнал
5 декабря 2005 г.	Новое содержимое: Добавлены сведения о группе Windows SQLServerNotificationServicesUser.

Поделиться через