Команда nscontrol create

Статья
12/15/2008

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

Создает новый экземпляр служб Microsoft SQL Server Notification Services.

Синтаксис

nscontrol create 
    [-nologo]
    [-help]
        -in configFile
    [-sqlusername sqlUserName  -sqlpassword sqlPassword]
    [-argumentkey key]
    [param=value ...]

Аргументы

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

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

-inconfigFile
Путь и имя файла конфигурации экземпляра (ICF), который определяет экземпляр. Если файл находится в текущем каталоге, указывать путь не требуется.

-sqlusernamesqlUserName
Определяет имя входа SQL Server, используемое для подключения к SQL Server.

При использовании проверки подлинности SQL Server для подключения к SQL Server укажите идентификатор входа с данным аргументом. Этот аргумент должен использоваться вместе с аргументом -sqlpassword.

Если для подключения к SQL Server используется проверка подлинности Windows, не применяйте аргументы -sqlusername и -sqlpassword.

Примечание.

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

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

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

-argumentkeykey
Задает ключ, используемый для шифрования аргументов поставщика событий и канала доставки, хранимых в базах данных служб Notification Services. Ключ представляет собой строку длиной до 2 500 символов.

Этот аргумент необходимо указывать, если значение EncryptArguments в файле конфигурации равно true. После выполнения команды nscontrol create невозможно изменить ключ, использованный при создании экземпляра. Чтобы изменить ключ, необходимо удалить и создать экземпляр повторно.

Это же значение ключа необходимо указывать при выполнении команд nscontrol register и nscontrol update. Команда nscontrol register шифрует значение ключа и хранит его в реестре.

param=value
Пара «имя/значение», используемая для передачи значений параметров из командной строки в файл ICF.

Любая строка между знаками процента (%) в файле ICF является перемещаемым параметром. Если файл ICF содержит перемещаемые параметры (такие, как DBSystem в следующем примере), укажите имя и значение параметра в командной строке (или в разделе ParameterDefaults файла ICF). Например, если файл конфигурации содержит следующий XML-код:
```
<SqlServerSystem>%DBSystem%</SqlServerSystem>
```
В этом случае можно указать имя и значение в команде nscontrol create следующим образом:
```
nscontrol create -in config.xml DBSystem=MySQLServer
```
Значения параметров, указанные в командной строке, устанавливаются для параметров в файле ICF, но не напрямую для параметров в файлах определения приложения (ADF). Чтобы изменить значения параметров в файле ADF, добавьте подраздел Parameters к разделу Application файла ICF. После этого можно использовать перемещаемые параметры и указывать их значения в командной строке.

Помимо указания параметров в командной строке можно также использовать переменные среды в файла ICF (например, %COMPUTERNAME%). Если в файле ICF используется переменная среды, обратите внимание, что пара «имя/значение» с тем же именем, введенная в командной строке, имеет более высокий приоритет, чем переменная среды.

Замечания

Команда nscontrol create проверяет файл ICF и файл ADF по их XML-схемам и находит недопустимые значения, например значение true одновременно для многоадресной и сводной доставки. Если проверки дают отрицательный результат, то nscontrol create останавливается, а экземпляр не создается.

Команда nscontrol create включает межбазовые цепочки владения в базах данных экземпляра и приложений. Включение межбазовых цепочек владения необходимо, чтобы хранимые процедуры службы Notification Services могли обращаться к объектам в базах данных экземпляра и приложений.

При использовании Notification Services Standard Edition, если один или более элементов не поддерживаются выпуском Standard Edition, выполнение команды nscontrol create прекращается, а экземпляр не создается. Дополнительные сведения о Notification Services Standard Edition см. в разделе Выпуски служб Notification Services.

Команду nscontrol create можно выполнять на любом компьютере, на котором установлены клиентские компоненты Notification Services и у которого есть доступ к ядру СУБД SQL Server, где будут храниться метаданные экземпляра и приложений.

Перед запуском экземпляра службы Notification Services необходимо зарегистрировать экземпляр с помощью команды nscontrol register. Регистрация создает запись реестра и дополнительно создает службу Windows, которую можно использовать для запуска экземпляра.

Команду nscontrol create нельзя использовать для обновления экземпляра. Для этого используется команда nscontrol update.

Разрешения

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

Примеры

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

A. Основной пример

В этом примере показано, как создать новый экземпляр служб Notification Services с помощью файла ICF InstanceConfig.xml, и подключиться к SQL Server с использованием проверки подлинности Windows.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml"

Б. Указание значений параметров файла конфигурации

В этом примере показано, как указать значения параметров BaseDirectoryPath, NSHost и SqlServer в ICF-файле. Команда nscontrol подключается к SQL Server с использованием проверки подлинности Windows.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    BaseDirectoryPath=C:\NS\Samples\Stock 
    NSHost=nsuetest SqlServer=nsuetest

В. Указание ключа шифрования аргументов

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

Команда nscontrol подключается к SQL Server с использованием проверки подлинности Windows.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -argumentkey "MyArgumentKey"

Г. Использование проверки подлинности SQL Server

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

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

См. также

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

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