Microsoft提供了一组可靠的命令行选项来执行和控制 SSMA 活动。 随后的各节详细介绍相同的内容。
SSMA 控制台中的命令行选项
此处介绍的控制台命令选项。
在本节中,术语“option”也可称为“switch”。
选项不区分大小写,可以以“-”或“/”字符开头。
如果指定了选项,则必须指定相应的选项参数。
选项参数必须用空格分隔选项字符。
语法示例:
C:\> SSMAforSybaseConsole.EXE -s scriptfileC:\> SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ServersConnectionFileSample.xml"应在双引号中指定包含空格的文件夹或文件名。
命令行条目和错误消息的输出存储在 STDOUT 或指定文件中。
脚本文件选项:-s/script
必需的参数,该脚本文件的路径/名称用于指定将由 SSMA 执行的命令序列脚本。
语法示例:
C:\>SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml"
变量值文件选项:-v/variable
此文件包含脚本文件中使用的变量。 这是一个可选开关。 如果未在变量文件中声明变量并在脚本文件中使用变量,应用程序将生成错误并终止控制台执行。
语法示例:
在多个变量值文件中定义的变量,可能是一个具有默认值,另一个变量具有实例特定的值(如果适用)。 命令行参数中指定的最后一个变量文件采用首选项,以防变量重复:
C:\>SSMAforSybaseConsole.EXE -s"C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v c:\migrationprojects\global_variablevaluefile.xml -v "c:\migrationprojects\instance_variablevaluefile.xml"
服务器连接文件选项:-c/serverconnection
此文件包含每个服务器的服务器连接信息。 每个服务器定义都由唯一的服务器 ID 标识。 脚本文件中引用了服务器 ID 用于连接相关的命令。
服务器定义可以是服务器连接文件和/或脚本文件的一部分。 脚本文件中的服务器 ID 优先于服务器连接文件,以防服务器 ID 重复。
语法示例:
服务器 ID 用于脚本文件中,它们在单独的服务器连接文件中定义,服务器连接文件使用变量值文件中定义的变量:
C:\>SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -vc:\SsmaProjects\myvaluefile1.xml -cc:\SsmaProjects\myserverconnectionsfile1.xml服务器定义嵌入脚本文件中:
C:\>SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml"
XML 输出选项:-x/xmloutput [xmloutputfile]
此命令用于将命令输出消息以 xml 格式输出到控制台或 xml 文件。
xmloutput(viz...)有两个选项可用:
如果在 xmloutput 参数后提供文件路径,输出将重定向到该文件。
语法示例:
C:\>SSMAforSybaseConsole.EXE -s"C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml如果在 xmloutput 开关之后未提供任何文件路径,则 xml 输出将显示在控制台中。
语法示例:
C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput
日志文件选项:-l/log
控制台应用程序中的所有 SSMA 操作都会记录在日志文件中。 这是一个可选开关。 如果在命令行中指定了日志文件及其路径,则日志将生成在指定位置。 否则,它会在其默认位置生成。
语法示例:
C:\>SSMAforSybaseConsole.EXE
"C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l c:\SsmaProjects\migration1.log
项目环境文件夹选项:-e/projectenvironment
这表示当前 SSMA 项目的项目环境设置文件夹。 此开关是可选的。
语法示例:
C:\>SSMAforSybaseConsole.EXE -s
"C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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 控制台选项的语法摘要:
C:\>SSMAforSybaseConsole.EXE -?
有关 SSMA 控制台命令行选项的表格显示,请参阅附录 - 1 (SybaseToSQL)。
SecurePassword 帮助选项:-securepassword -?/帮助
显示 SSMA 控制台选项的语法摘要:
C:\>SSMAforSybaseConsole.EXE -securepassword -?
有关 SSMA 控制台命令行选项的表格显示,请参阅 附录 - 1 (SybaseToSQL)
下一步
下一步取决于项目要求:
有关指定密码或导出/导入密码,请参阅管理密码(SybaseToSQL)。
有关生成报表,请参阅生成报告(SybaseToSQL)。
有关控制台中问题的疑难解答,请参阅故障排除(SybaseToSQL)。