Microsoft提供了一组可靠的命令行选项来执行和控制 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
此文件包含每个服务器的服务器连接信息。 每个服务器定义都由唯一的服务器 ID 标识。 脚本文件引用连接相关命令中的每个服务器 ID。
服务器定义可以是服务器连接文件的一部分,也可以是脚本文件的一部分。 如果服务器 ID 重复,脚本文件服务器 ID 优先于服务器连接文件。
语法示例:
在脚本文件中使用服务器 ID,并在单独的服务器连接文件中定义它们。 此文件使用变量值文件中定义的变量:
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以下子选项:
为指定的服务器 ID 或在服务器连接文件中定义的所有服务器 ID 添加或更新受保护存储中的密码:
-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]从指定服务器 ID 的受保护存储或所有服务器 ID 的受保护存储中删除加密密码:
-p/securepassword -r/remove {<server_id> [, ...n] | all}显示加密密码的服务器 ID 列表:
-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>可以使用逗号分隔符指定多个服务器 ID。
帮助选项:-?/帮助
显示 SSMA 控制台选项的语法摘要。
有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 - 1。
语法示例:
SSMAforAccessConsole.exe -?
SecurePassword 帮助选项:-securepassword -?/帮助
显示 SSMA 控制台选项的语法摘要:
有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 - 1。
语法示例:
SSMAforAccessConsole.exe -securepassword -?