Команда nscontrol export

Статья
12/15/2008

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

Создает XML-файл конфигурации экземпляра (ICF) и один или более XML-файлов определения приложения (ADF) (по одному на приложение), экспортируя метаданные из баз данных. Получаемые в результате файлы являются допустимыми определениями экземпляра и приложений во время выполнения команды экспорта. Эти данные можно использовать для резервного копирования определений экземпляра и приложений или создания файлов, используемых для создания и обновления экземпляра.

Синтаксис

nscontrol export 
    [-nologo]
    [-help] 
        -name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-out directory]
    [-force]

Аргументы

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

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

-nameinstanceName
Имя экземпляра, на основе которого будут создаваться файлы конфигурации и файлы определения приложений.

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

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

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

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

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

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

-sqlpasswordsqlPassword
Является паролем, связанным с именем входа -sqlusername. Этот аргумент следует указывать только при соединени с использованием проверки подлинности SQL Server.

-outdirectory
Каталог, в который производится запись файлов. По умолчанию используется текущий каталог.

-force
Разрешает перезапись существующих файлов с одинаковыми именами в каталоге выхода.

Замечания

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

Получаемый в результате файл конфигурации имеет имя <имя_экземпляра>.config.xml. Каждый получаемый в результате ADF-файл получает имя <имя_экземпляра>.<имя_приложения>.adf.xml.

Команда nscontrol export производит запись файлов с использованием кодировки UTF-8. Чтобы экспортировать файлы конфигурации и файлы определения приложения в других кодировках, используйте команду Экспорт среды SQL Server Management Studio.

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

Команда nscontrol export изменяет значения ApplicationDefinitionFilePath в файле конфигурации, чтобы они указывали на экспортируемые ADF-файлы. Этот путь изменяется так, чтобы файл конфигурации мог использоваться сразу. Все другие настройки пути, включая BaseDirectoryPath, остаются неизменными, потому что они могут указывать на другие файлы, необходимые для экземпляра (например файлы модуля форматирования данных).

Разрешения

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

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

Примеры

Следующие примеры иллюстрируют способ экспорта метаданных в XML-файлы.

A. Экспорт файлов в текущий каталог

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

nscontrol export -name StockInstance

Б. Экспорт файлов в определенный каталог с перезаписью существующих файлов

Этот пример показывает, как назначить каталог для создаваемых файлов экземпляра и приложений. Он также показывает, как использовать аргумент –force для перезаписи всех существующих файлов с теми же именами.

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

nscontrol export -name StockInstance -out "C:\NS\Export" -force

В. Экспорт файлов с администраторского компьютера

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

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

nscontrol export -name StockInstance -server nsuetest 
    -out "C:\NS\Export" -force

Г. Экспорт файлов с использованием проверки подлинности SQL Server

Этот пример показывает, как экспортировать данные экземпляра StockInstance, используя проверку подлинности SQL Server для соединения с SQL Server. Файлы конфигурации и файлы определения приложений создаются в каталоге «C:\NS\Export», но перезапись в случае их существования не производится.

nscontrol export -name StockInstance -out "C:\NS\Export" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

См. также

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

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

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