SSMA 控制台中的命令行选项 (Db2ToSQL)
SQL Server 迁移助手(SSMA)提供一组可靠的命令行选项来执行和控制 Db2 活动。 随后的各节详细介绍相同的内容。
SSMA 控制台中的命令行选项
本部分介绍控制台命令选项,也称为开关。
选项不区分大小写,可能以任一字符 -
或 /
字符开头。
如果指定了选项,则必须指定相应的选项参数。
选项参数必须用空格与选项字符分隔开。
语法示例:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ServersConnectionFileSample.xml"
应在双引号中指定包含空格的文件夹和文件名。
命令行条目和错误消息的输出存储在 STDOUT 或指定文件中。
脚本文件选项:-s |脚本
强制开关,脚本文件路径/名称指定 SSMA 执行的命令序列脚本。
语法示例:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"
变量值文件选项:-v |变量
此文件包含在脚本文件中使用的变量。 此开关是可选的。 如果未在变量文件中声明变量并在脚本文件中使用变量,则应用程序将生成错误并终止控制台执行。
语法示例:
在多个变量值文件中定义的变量,可能有一个变量具有默认值,另一个变量具有实例特定的值(如果适用)。 命令行参数中指定的最后一个变量文件采用首选项,以防变量重复:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migration projects\global_variablevaluefile.xml -v "C:\migrationprojects\instance_variablevaluefile.xml"
服务器连接文件选项:-c |serverconnection
此文件包含每个服务器的服务器连接信息。 每个服务器定义都用唯一的服务器 ID 来标识。 服务器 ID 在脚本文件中引用,用于连接相关命令。
服务器定义可能是服务器连接文件和/或脚本文件的一部分。 脚本文件中的服务器 ID 优先于服务器连接文件,以防服务器 ID 重复。
语法示例:
服务器 ID 用于脚本文件中,并在单独的服务器连接文件中定义它们。 服务器连接文件使用变量,这些变量在变量值文件中定义:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\SsmaProjects\myvaluefile1.xml -c C:\SsmaProjects\myserverconnectionsfile1.xml
服务器定义嵌入在脚本文件中:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"
XML 输出选项:-x |xmloutput [ xmloutputfile ]
此命令用于将命令输出消息以 XML 格式输出到控制台或 XML 文件。
有两个选项可供 xmloutput
使用,例如:
如果在切换后
xmloutput
提供文件路径,则输出将重定向到该文件。语法示例:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml
如果在切换后
xmloutput
未提供文件路径,则会xmlout
在控制台本身上显示该文件路径。语法示例:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput
日志文件选项:-l |日志
控制台应用程序中的所有 SSMA 操作均记录在日志文件中。 此开关是可选的。 如果在命令行中指定了日志文件及其路径,则日志将在指定位置生成。 否则,它将在默认位置生成。
语法示例:
SSMAforDb2Console.exe "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l C:\SsmaProjects\migration1.log
项目环境文件夹选项:-e |projectenvironment
表示当前 SSMA 项目的项目环境设置文件夹。 此开关是可选的。
语法示例:
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e C:\SsmaProjects\CommonEnvironment
安全密码选项:-p |securepassword
此选项指示用于服务器连接的加密密码。 它不同于所有其他选项:该选项不执行任何脚本,也不有助于任何与迁移相关的活动。 相反,它有助于管理迁移项目中使用的服务器连接的密码加密。
不能输入任何其他选项或密码作为命令行参数。 否则,将导致错误。 有关详细信息,请参阅 “管理密码”。
-p | securepassword
支持以下子选项:
针对指定的服务器 ID 或在服务器连接文件中定义的所有服务器 ID,为受保护存储添加密码。 如果密码已存在,则
-overwrite
此选项将更新密码:-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 控制台选项的语法摘要:
SSMAforDb2Console.exe -?
有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 1:控制台命令行选项。
SecurePassword 帮助选项:-securepassword -? |帮助
显示 SSMA 控制台选项的语法摘要:
SSMAforDb2Console.exe -securepassword -?
有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 1:控制台命令行选项