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

  • 项目

Microsoft 提供一组可靠的命令行选项，用来执行和控制 SSMA 活动。 随后的部分提供其他详细信息。

SSMA 控制台中的命令行选项

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

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

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

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

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

语法示例：

C:\> SSMAforAccessConsole.EXE -s scriptfile

C:\> 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 执行的命令序列的脚本。

语法示例：

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

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

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

语法示例：

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

    C:\>SSMAforAccessConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\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 用于脚本文件。 在单独的服务器连接文件中定义服务器 ID。 此文件使用变量值文件中定义的变量：

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

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

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

    语法示例：

    C:\>SSMAforAccessConsole.EXE -s

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

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

    语法示例：

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

日志文件选项：-l/log

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

语法示例：

C:\>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 项目的项目环境设置文件夹。

语法示例：

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

帮助选项： -？/Help

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

C:\>SSMAforAccessConsole.EXE -?

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

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

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

C:\>SSMAforAccessConsole.EXE -securepassword -?

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

后续步骤

下一步取决于项目要求：

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

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

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