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

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

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

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

В этом разделе описаны параметры команды консоли.

В этом разделе опция и переключатель обозначают одно и то же.

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

При указании опций необходимо также указать соответствующие параметры опций.

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

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

SSMAforAccessConsole.exe -s scriptfile

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.

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

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

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

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

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

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

SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migrationprojects\global_variablevaluefile.xml -v "C:\migrationprojects\instance_variablevaluefile.xml"

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

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

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

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

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

    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

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

    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, перенаправьте выходные данные в файл.

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

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

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

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

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

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

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

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

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.

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

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.

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

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

SSMAforAccessConsole.exe -?

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

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

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

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

SSMAforAccessConsole.exe -securepassword -?

Связанный контент

  • Last updated on