Compartir por

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

  • Artigo

Microsoft le proporciona sólidas opciones de línea de comandos para ejecutar y controlar las actividades de SSMA. Las secciones siguientes ofrecen más información.

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

Aquí se describen las opciones de comandos de la consola.

A efectos de esta sección, el término "opción" también se denomina "switch".

Las opciones no distinguen mayúsculas de minúsculas y pueden comenzar con el carácter "-" o "/".

Si se especifican opciones, es obligatorio 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:

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"

Los nombres de carpeta o archivo que contienen espacios deben especificarse entre comillas dobles.

La salida de entradas de línea de comandos y mensajes de error se almacena en STDOUT o en un archivo especificado.

Opción de archivo de script: -s/script

Un modificador obligatorio, la ruta o el nombre del archivo de script especifica el script de las secuencias de comandos que SSMA va a ejecutar.

Ejemplos de sintaxis:

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

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

El archivo de valor de variable consta de variables usadas 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.

Ejemplos 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 tiene preferencia, en caso de que haya una duplicación de variables:

    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"

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 del servidor.

Ejemplos de sintaxis:

  • Los identificadores de servidor se usan en el archivo de script. Se definen en un archivo de conexión de servidor independiente. Este archivo usa variables definidas en el archivo de valor de variable:

    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

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

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\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, a saber:

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

    Ejemplo de sintaxis:

    C:\>SSMAforAccessConsole.EXE -s

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

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

    Ejemplo de sintaxis:

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

Opción de archivo de registro: -l/log

Todas las operaciones SSMA de la aplicación de la consola se registran en un archivo de registro y el 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:

C:\>SSMAforAccessConsole.EXE

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

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

Este modificador opcional se refiere a la carpeta de configuración del entorno del proyecto para el proyecto SSMA actual.

Ejemplo de sintaxis:

C:\>SSMAforAccessConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for Access\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 en que no ejecuta ningún script ni ayuda en ninguna actividad relacionada con la migración, pero 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 la sección Administrar contraseñas.

En -p/securepassword se admiten las siguientes subopciones:

  • Para agregar una contraseña o actualizar una existente 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:

    -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 el archivo se descifra, se almacena en un nuevo archivo, 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: -?/Help

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

C:\>SSMAforAccessConsole.EXE -?

Para ver una presentación tabular de las opciones de la línea de comandos de la consola de SSMA, consulte Apéndice - 1 (AccessToSQL).

Opción de ayuda SecurePassword: -securepassword -?/Help

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

C:\>SSMAforAccessConsole.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 (AccessToSQL)

Pasos siguientes

El siguiente paso depende de los requisitos del proyecto:

  1. Para especificar una contraseña o exportar/importar contraseñas, consulte Administración de contraseñas (AccessToSQL).

  2. Para generar informes, consulte Generación de informes (AccessToSQL).

  3. Para solucionar problemas en la consola, consulte Solución de problemas (AccessToSQL).