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

Параметры командной строки в консоли 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 -?/Help

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

C:\>SSMAforAccessConsole.EXE -securepassword -?

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

Далее

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

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

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

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