Команда nscontrol status

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

Отображает состояние (включено или отключено) указанного экземпляра, приложений и их компонентов. Она также отображает состояние службы Windows NS$<имя_экземпляра> или служб, связанных с экземпляром.

Синтаксис

nscontrol status 
    [-nologo]
    [-help]
        -name instanceName
    [-server databaseServer] 
    [-application applicationName] 
    [-sqlusername sqlUserName -sqlpassword sqlPassword]

Аргументы

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

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

• -nameinstanceName
  Имя экземпляра, состояние которого выводится в отчете.

• -serverdatabaseServer
  Имя сервера, на котором размещены базы данных экземпляров и приложений.

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

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

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

• -sqlusernamesqlUserName
  Если для соединения с SQL Server используется проверка подлинности SQL Server, то необходимо указать оба аргумента, -sqlusername и -sqlpassword.

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

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

Замечания

Команда nscontrol status отображает состояние каждого компонента с указанием имени системы в скобках.

Внутрипроцессные поставщики событий, генератор и распространители могут иметь следующие значения состояния: «Включен», «Ожидание включения», «Отключен», «Ожидание отключения». Описания возможных значений состояний см. в разделе Просмотр состояния экземпляров, приложений и компонентов.

Состояние компонентов обновляется при запуске службы. В случае горизонтального масштабирования экземпляра на нескольких компьютерах необходимо запустить все службы Windows для обновления всех состояний.

Подписчики и подписки могут иметь включенное или отключенное состояние. Эти компоненты не зависят от службы Windows NS$instance_name.

Команды nscontrol enable и nscontrol disable также показывают сведения о состоянии.

Разрешения

Учетная запись, используемая для запуска nscontrol status, или идентификатор входа SQL Server, указанный аргументом -sqlusername, должны являться членами одной из следующих ролей баз данных: NSAnalysis, NSDistributor, NSEventProvider, NSGenerator, NSReader, NSRunService, NSSubscriberAdmin или NSVacuum.

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

Если для запуска экземпляра Notification Services используются службы Windows NS$<instanceName>, то команда nscontrol status отображает состояние каждой из этих служб, поэтому данная учетная запись должна иметь права администратора на всех компьютерах, где выполняется эта служба.

Примеры

Следующие примеры иллюстрируют способы отображения состояния в нескольких сценариях.

A. Отображение состояния экземпляра

Этот пример показывает способ отображения состояния экземпляра с именем StockInstance. Программа nscontrol использует проверку подлинности Windows для соединения с SQL Server.

nscontrol status -name StockInstance

Б. Отображение состояния приложения

Этот пример показывает, как отобразить состояние приложения Stock в экземпляре с именем StockInstance. Программа nscontrol использует проверку подлинности Windows для соединения с SQL Server.

nscontrol status -name StockInstance -application Stock

В. Отображение состояния экземпляра, запущенного на административном компьютере

Этот пример показывает, как отобразить состояние экземпляра, когда этот экземпляр не зарегистрирован на компьютере. Для отображения состояния следует использовать аргумент –server для указания имени сервера базы данных.

Программа nscontrol использует проверку подлинности Windows для соединения с SQL Server.

nscontrol status -name StockInstance -server nsuetest 
    -application Stock 

Г. Отображение состояния экземпляра с использованием проверки подлинности SQL Server

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

Этот пример показывает способ отображения состояния экземпляра с именем StockInstance, используя проверку подлинности SQL Server для соединения с SQL Server.

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

См. также

Справочник

Программа nscontrol

Другие ресурсы

Просмотр состояния экземпляров, приложений и компонентов

Справка и поддержка

Получение помощи по SQL Server 2005

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