通过

SSMA 控制台中的命令行选项 (DB2ToSQL)

  • 项目

Microsoft 提供了一组可靠的命令行选项，用来执行和控制 SSMA 活动。 随后的各节详细介绍相同的内容。

SSMA 控制台中的命令行选项

此处介绍的是控制台命令选项。

在本部分中，术语“选项”也称为“开关”。

选项不区分大小写，可能以“-”或“/”字符开头。

如果指定了选项，则还必须指定相应的选项参数。

选项参数必须用空格与选项字符分隔开。

语法示例：

C:\> SSMAforDB2Console.EXE -s scriptfile

C:\> 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/script

必需的开关，脚本文件路径/名称指定要由 SSMA 执行的命令序列的脚本。

语法示例：

C:\>SSMAforDB2Console.EXE -s "C Program Files\Microsoft SQL Server Migration Assistant for DB2\Sample Console Scripts \ConversionAndDataMigrationSample.xml"

变量值文件选项：-v/variable

此文件包含在脚本文件中使用的变量。 这是可选开关。 如果未在变量文件中声明变量，并在脚本文件中使用变量，应用程序将生成错误，并且终止控制台执行。

语法示例：

  • 在多个变量值文件中定义的变量，可能有一个变量具有默认值，另一个变量具有实例特定的值（如果适用）。 在命令行参数中指定的最后一个变量文件优先，以防变量重复：

    C:\>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 在脚本文件中使用，它们在单独的服务器连接文件中定义，而服务器连接文件则使用在变量值文件中定义的变量：

    C:\>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

  • 服务器定义嵌入在脚本文件中：

    C:\>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 开关后提供 filepath，则将输出重定向到该文件。

    语法示例：

    C:\>SSMAforDB2Console.EXE -s

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

  • 如果在 xmloutput 开关后未提供 filepath，则 xmlout 将显示在控制台上。

    语法示例：

    C:\>SSMAforDB2Console.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for DB2\Sample Console Scripts \ConversionAndDataMigrationSample.xml" -xmloutput

日志文件选项：-l/log

控制台应用程序中的所有 SSMA 操作均记录在日志文件中。 这是可选开关。 如果在命令行中指定了日志文件及其路径，则日志将在指定位置生成。 否则，它将在默认位置生成。

语法示例：

C:\>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 项目的项目环境设置文件夹。 此开关是可选的。

语法示例：

C:\>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。

帮助选项： -？/Help

显示 SSMA 控制台选项的语法摘要：

C:\>SSMAforDB2Console.EXE -?

有关 SSMA 控制台命令行选项的表格显示，请参阅附录 - 1 (DB2ToSQL)。

SecurePassword 帮助选项：-securepassword -?/Help

显示 SSMA 控制台选项的语法摘要：

C:\>SSMAforDB2Console.EXE -securepassword -?

有关 SSMA 控制台命令行选项的表格显示，请参阅附录 - 1 (DB2ToSQL)

下一步

下一步取决于项目要求：

  1. 有关指定密码或导出/导入密码的信息，请参阅管理密码 (DB2ToSQL)。

  2. 有关生成报告的信息，请参阅生成报告 (DB2ToSQL)。

  3. 有关控制台中故障排除问题的信息，请参阅故障排除 (DB2ToSQL)。