Команда nscontrol upgrade

Статья
12/15/2008

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

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

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

Синтаксис

nscontrol upgrade
    [-nologo]
    [-help]
        –name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-timeout seconds]

Аргументы

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

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

-nameinstanceName
Имя обновляемого экземпляра.

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

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

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

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

-sqlusernamesqlUserName
Имя входа SQL Server, используемое программой nscontrol для подключения к серверу службы SQL Server.

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

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

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

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

-timeout seconds
Время ожидания завершения каждого действия обновления (в секундах). По умолчанию период ожидания составляет 30 секунд. Если в процессе обновления экземпляра служб Notification Services возникают ошибки, связанные с истечением времени ожидания, установите более продолжительный интервал.

Замечания

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

Важно!
Чтобы обновить в реестре сведения для экземпляра, после выполнения команды nscontrol upgrade выполните команду nscontrol register.

При выполнении команды nscontrol upgrade версия и выпуск обновления зависят от версии и выпуска программы nscontrol. Например, чтобы обновить экземпляр, созданный в версии служб Notification Services 2.0.3008.0, до версии 9.0.242, запустите команду nscontrol upgrade из папки 9.0.242\bin.

Команда nscontrol upgrade проверяет базу данных экземпляра, чтобы найти в метаданных номер версии и выпуска экземпляра. Если в метаданных указана более ранняя версия или выпуск, команда nscontrol upgrade проверяет, отключен ли экземпляр. Если это так, программа nscontrol выполняет обновление.

Примечание.
Команда nscontrol upgrade устанавливает режим совместимости базы данных равным 90.

Команда nscontrol upgrade предназначена для обновления экземпляра служб Notification Services без перемещения. Если в ходе обновления экземпляр перемещается, необходимо изменить значения SystemName в файле определения приложения (ADF), затем выполнить обновление значений в базах данных с помощью программы nscontrol update. Если значения SystemName в базах данных не соответствуют реальным системным именам, то компоненты не запустятся и службы Notification Services не смогут обрабатывать уведомления. Дополнительные сведения о перемещении экземпляров см. в разделе Перемещение экземпляров служб Notification Services.

Разрешения

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

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

Примеры

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

A. Обновление экземпляра с использованием проверки подлинности Windows

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

nscontrol upgrade -name StockInstance -server nsuetest

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

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

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

nscontrol upgrade -name StockInstance -server nsuetest
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

См. также

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

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

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