Compartir a través de

Opciones de línea de comandos en la consola de SSMA (Db2ToSQL)

  • Artículo

SQL Server Migration Assistant (SSMA) proporciona un conjunto sólido de opciones de línea de comandos para ejecutar y controlar las actividades de Db2. Las secciones siguientes detallan lo mismo.

Opciones de línea de comandos en la consola de SSMA

En esta sección se describen las opciones de comando de la consola, también conocidas como modificadores.

Las opciones no distinguen mayúsculas de minúsculas y pueden empezar por caracteres - o / .

Si se especifican opciones, debe especificar los parámetros de opción correspondientes.

Los parámetros de opción deben estar separados del carácter de opción por un espacio en blanco.

Ejemplos de sintaxis:

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"

Las carpetas y los nombres de archivo que contienen espacios deben especificarse entre comillas dobles.

La salida de las entradas de la línea de comandos y los mensajes de error se almacenan en STDOUT o en un archivo especificado.

Opción de archivo de script: -s | Guión

Un modificador obligatorio, la ruta de acceso o nombre del archivo de script especifica el script de secuencias de comandos que ejecuta SSMA.

Ejemplo de sintaxis:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Opción de archivo de valor variable: -v | variable

Este archivo contiene las variables que se usan en el archivo de script. Este modificador es opcional. Si las variables no se declaran en el archivo de variables y se usan en el archivo de script, la aplicación genera un error y finaliza la ejecución de la consola.

Ejemplo de sintaxis:

Variables definidas en varios archivos de valor de variables, quizás uno con un valor predeterminado y otro con un valor específico de instancia cuando sea aplicable. El último archivo de variable especificado en los argumentos de la línea de comandos toma la preferencia, en caso de que haya una duplicación de variables:

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"

Opción de archivo de conexión del servidor: -c | serverconnection

Este archivo contiene información de conexión del servidor para cada servidor. Cada definición de servidor se identifica mediante un identificador de servidor único. Se hace referencia a los identificadores de servidor en el archivo de script para los comandos relacionados con la conexión.

La definición del servidor puede formar parte del archivo de conexión del servidor o del archivo de script. El identificador de servidor en el archivo de script tiene prioridad sobre el archivo de conexión del servidor, en caso de que haya una duplicación del identificador de servidor.

Ejemplos de sintaxis:

  • Los identificadores de servidor se usan en el archivo de script y los define en un archivo de conexión de servidor independiente. El archivo de conexión del servidor usa variables, que se definen en el archivo de valor de variable:

    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

  • La definición del servidor está incrustada en el archivo de script:

    SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Opción de salida XML: -x | xmloutput [ xmloutputfile ]

Este comando se usa para generar los mensajes de salida del comando en un formato XML en la consola o en un archivo XML.

Hay dos opciones disponibles para xmloutput, por ejemplo:

  • Si la ruta de acceso del archivo se proporciona después del xmloutput modificador, la salida se redirige al archivo.

    Ejemplo de sintaxis:

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

  • Si no se proporciona ninguna ruta de acceso de archivo después del xmloutput modificador, xmlout se muestra en la propia consola.

    Ejemplo de sintaxis:

    SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Opción de archivo de registro: -l | registro

Todas las operaciones SSMA de la aplicación de la consola se registran en un archivo de registro. Este modificador es opcional. Si se especifica un archivo de registro y su ruta de acceso en la línea de comandos, el registro se genera en la ubicación especificada. De lo contrario, se genera en su ubicación predeterminada.

Ejemplo de sintaxis:

SSMAforDb2Console.exe "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l C:\SsmaProjects\migration1.log

Opción de carpeta del entorno del proyecto: -e | projectenvironment

Denota la carpeta de configuración del entorno del proyecto para el proyecto SSMA actual. Este modificador es opcional.

Ejemplo de sintaxis:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e C:\SsmaProjects\CommonEnvironment

Opción de contraseña segura: -p | securepassword

Esta opción indica la contraseña cifrada para las conexiones de servidor. Difiere de todas las demás opciones: la opción no ejecuta ningún script o ayuda en ninguna actividad relacionada con la migración. En su lugar, ayuda a administrar el cifrado de contraseñas para las conexiones de servidor usadas en el proyecto de migración.

No puede escribir ninguna otra opción o contraseña como parámetro de línea de comandos. De lo contrario, se producirá un error. Para obtener más información, consulte Administrar contraseñas.

En -p | securepassword se admiten las siguientes subopciones:

  • Para agregar una contraseña al almacenamiento protegido para un identificador de servidor especificado o para todos los identificadores de servidor definidos en el archivo de conexión del servidor. La -overwrite opción actualiza la contraseña si ya existe:

    -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]

  • Para quitar la contraseña cifrada del almacenamiento protegido del identificador de servidor especificado o para todos los identificadores de servidor:

    -p | securepassword -r | remove { <server_id> [, ...n] | all }

  • Para mostrar una lista de identificadores de servidor para los que se cifra la contraseña:

    -p | securepassword -l | list

  • Para exportar las contraseñas almacenadas en el almacenamiento protegido a un archivo cifrado. Este archivo se cifra con la frase de contraseña especificada por el usuario.

    -p | securepassword -e | export { <server-id> [, ...n] | all } <encrypted-password-file>

  • El archivo cifrado que se exportó anteriormente se importa al almacenamiento protegido local mediante la frase de contraseña especificada por el usuario. Una vez que se descifra el archivo, se almacena en un archivo nuevo, que a su vez, se cifra en el equipo local.

    -p | securepassword -i | import { <server-id> [, ...n] | all } <encrypted-password-file>

    Se pueden especificar varios identificadores de servidor mediante separadores de comas.

Opción de ayuda: -? | Ayuda

Muestra el resumen de sintaxis de las opciones de la consola de SSMA:

SSMAforDb2Console.exe -?

Para ver una presentación tabular de las opciones de la línea de comandos de la consola de SSMA, vea apéndice 1: Opciones de línea de comandos de consola.

Opción de ayuda SecurePassword: -securepassword -? | Ayuda

Muestra el resumen de sintaxis de las opciones de la consola de SSMA:

SSMAforDb2Console.exe -securepassword -?

Para ver una presentación tabular de las opciones de la línea de comandos de la consola de SSMA, consulte apéndice 1: Opciones de línea de comandos de consola.

Contenido relacionado