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

Параметры командной строки в консоли SSMA (AccessToSQL)

Корпорация Майкрософт предоставляет надежный набор параметров командной строки для выполнения и управления действиями SSMA. В последующих разделах приведены дополнительные сведения.

Параметры командной строки в консоли SSMA

Здесь описаны параметры команды консоли.

Для целей данного раздела термин "option" также обозначается как "switch".

Параметры не зависят от регистра и могут начинаться с символа "-" или "/".

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

Параметры опции должны отделяться от символа опции пробелом.

Примеры синтаксиса :

C:\> SSMAforAccessConsole.EXE -s scriptfile

C:\> SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ServersConnectionFileSample.xml"

Имена папок или файлов, содержащих пробелы, должны быть указаны в двойных кавычках.

Выходные данные записей командной строки и сообщений об ошибках хранятся в STDOUT или в указанном файле.

Параметр файла скрипта: -s/script

Обязательный переключатель, путь к файлу скрипта или имя указывает сценарий последовательностей команд, выполняемых SSMA.

Примеры синтаксиса :

C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Опция файла значения переменной: -v/variable

Файл значения переменной состоит из переменных, используемых в файле скрипта. Переключатель необязателен. Если переменные не объявляются в файле переменных и используются в файле скрипта, приложение создает ошибку и завершает выполнение консоли.

Примеры синтаксиса :

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

    C:\>SSMAforAccessConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v c:\migration

    projects\global_variablevaluefile.xml -v "c:\migrationprojects\instance_variablevaluefile.xml"

Параметр файла подключения к серверу: -c/serverconnection

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

Определение сервера может быть частью файла подключения к серверу и /или файла скрипта. Идентификатор сервера в файле скрипта имеет приоритет над файлом подключения сервера, если существует дублирование идентификатора сервера.

Примеры синтаксиса :

  • Идентификаторы сервера используются в файле скрипта. Они определены в отдельном файле подключения к серверу. Этот файл использует переменные, определенные в файле значения переменной:

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v

    c:\SsmaProjects\myvaluefile1.xml -c

    c:\SsmaProjects\myserverconnectionsfile1.xml

  • Определение сервера внедрено в файл скрипта:

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Параметр выходных данных XML: -x/xmloutput [xmloutputfile]

Эта команда используется для вывода выходных сообщений команды в формате XML в консоли или в XML-файл.

Существует два варианта для xmloutput, а именно:

  • Если файловый путь предоставляется после параметра xmloutput, выходные данные перенаправляются в файл.

    Пример синтаксиса :

    C:\>SSMAforAccessConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml

  • Если путь к файлу не указан после параметра xmloutput, то xmlout отображается непосредственно в консоли.

    Пример синтаксиса :

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Параметр файла журнала: -l/log

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

Пример синтаксиса :

C:\>SSMAforAccessConsole.EXE

"C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l c:\SsmaProjects\migration1.log

Параметр папки среды проекта: -e/projectenvironment

Этот необязательный параметр обозначает папку параметров среды проекта для текущего проекта SSMA.

Пример синтаксиса :

C:\>SSMAforAccessConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e c:\SsmaProjects\CommonEnvironment

Параметр безопасного пароля: -p/securepassword

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

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

Для -p/securepasswordподдерживаются следующие подпараметры:

  • Чтобы добавить пароль или обновить существующий пароль, чтобы защитить хранилище для указанного идентификатора сервера или для всех идентификаторов сервера, определенных в файле подключения сервера:

    -p|-securepassword -a|add {"<server_id>[, .n]"|all}``-c|-serverconnection <server-connection-file> [-v|variable <variable-value-file>]``[-o|overwrite]

    -p|-securepassword -a|add {"<server_id>[, .n]"|all}``-s|-script <server-connection-file> [-v|variable <variable-value-file>] [-o|overwrite]

  • Чтобы удалить зашифрованный пароль из защищенного хранилища указанного идентификатора сервера или для всех идентификаторов сервера:

    -p/securepassword -r/remove {<server_id> [, ...n] | all}

  • Чтобы отобразить список идентификаторов сервера, для которых зашифрован пароль:

    -p/securepassword -l/list

  • Экспорт паролей, хранящихся в защищенном хранилище, в зашифрованный файл. Этот файл шифруется с помощью указанной пользователем парольной фразы.

    -p/securepassword -e/export {<server-id> [, ...n] | all} <encrypted-password -file>

  • Зашифрованный файл, который был экспортирован ранее, импортируется в локально защищенное хранилище с помощью указанной пользователем парольной фразы. После расшифровки файла он хранится в новом файле, который, в свою очередь, шифруется на локальном компьютере.

    -p/securepassword -i/import {<server-id> [, ...n] | all} <encrypted-password -file>

    Несколько идентификаторов сервера можно указать с помощью разделителей-запятыми.

Вариант справки: -?/Help

Отображает сводку синтаксиса параметров консоли SSMA:

C:\>SSMAforAccessConsole.EXE -?

Табличное отображение параметров командной строки консоли SSMA см. в приложении - 1 (AccessToSQL).

Опция помощи SecurePassword: -securepassword -?/Справка

Отображает сводку синтаксиса параметров консоли SSMA:

C:\>SSMAforAccessConsole.EXE -securepassword -?

Табличное отображение параметров командной строки консоли SSMA см. в приложении - 1 (AccessToSQL)

Дальнейшие действия

Следующий шаг зависит от требований проекта:

  1. Сведения об указании пароля или импорта паролей см. в разделе Управление паролями (AccessToSQL).

  2. Для создания отчетов см. в Создание отчетов (AccessToSQL).

  3. Для устранения неполадок в консоли см. раздел "Устранение неполадок (AccessToSQL)".