Compartir a través de

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

Microsoft proporciona un conjunto sólido de opciones de línea de comandos para ejecutar y controlar las actividades de SQL Server Migration Assistant (SSMA). Obtenga más información en las secciones siguientes.

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

En esta sección se describen las opciones de comando de la consola.

En esta sección, los términos opción y modificador hacen referencia a lo mismo.

Las opciones no distinguen mayúsculas de minúsculas y pueden comenzar con - o /.

Si especifica opciones, también debe especificar los parámetros de opción correspondientes.

Debe separar los parámetros de opción del carácter de opción mediante espacios en blanco.

Ejemplos de sintaxis:

SSMAforAccessConsole.exe -s scriptfile

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 con comillas dobles.

La salida de entradas de línea de comandos y mensajes de error va a stdout o a un archivo especificado.

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

Utilice este modificador obligatorio para especificar la ruta de acceso y el nombre del archivo de script. El archivo de script contiene secuencias de comandos que ejecuta SSMA.

Ejemplo de sintaxis:

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

Utilice este parámetro opcional para especificar un archivo de valores de variable. El archivo contiene variables usadas en el archivo de script. Si el archivo de script usa variables que no se declaran en un archivo de valor de variable, SSMA genera un error y finaliza la ejecución de la consola.

Ejemplo de sintaxis:

Defina variables en varios archivos de valor de variable, como un archivo con valores predeterminados y otro archivo con valores específicos de la instancia. Si hay una duplicación de variables, el último archivo de variable especificado en los argumentos de la línea de comandos tiene preferencia:

SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migrationprojects\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. El archivo de script hace referencia a cada identificador de servidor en los comandos relacionados con la conexión.

Una definición de servidor puede formar parte de un archivo de conexión de servidor o de un archivo de script. Si hay una duplicación del identificador de servidor, el identificador del servidor de archivos de script tiene prioridad sobre el archivo de conexión del servidor.

Ejemplos de sintaxis:

  • Use identificadores de servidor en el archivo de script y definalos en un archivo de conexión de servidor independiente. Este archivo usa variables definidas en el archivo de valor de variable:

    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

  • Inserte la definición del servidor en el archivo de script:

    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]

Use este comando para generar los mensajes de salida del comando en formato XML, ya sea en la consola o en un archivo XML.

xmloutput tiene dos opciones.

  • Si proporciona la ruta de acceso del archivo después del xmloutput conmutador, redirija la salida al archivo.

    Ejemplo de sintaxis:

    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 proporciona una ruta de acceso de archivo después del xmloutput conmutador, la salida se visualizará en la consola.

    Ejemplo de sintaxis:

    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

La aplicación Consola registra todas las operaciones de SSMA en un archivo de registro. El interruptor es opcional. Si 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, el registro se genera en su ubicación predeterminada.

Ejemplo de sintaxis:

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

Utilice este interruptor opcional para definir la carpeta de configuración del entorno del proyecto para el actual proyecto de SSMA.

Ejemplo de sintaxis:

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

Use esta opción para especificar 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. En su lugar, ayuda a administrar el cifrado de contraseñas para las conexiones de servidor usadas en el proyecto de migración.

Al usar esta opción, debe ser el único parámetro que proporcione. Cualquier otra opción o contraseña hace que se produzca un error en el comando. Para obtener más información, consulte la sección Administrar contraseñas .

Se admiten las siguientes subopciones para -p/securepassword:

  • Agregue o actualice una contraseña en el 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]

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

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

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

    -p/securepassword -l/list

  • Exporte 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 exportado anteriormente se importa al almacenamiento protegido local mediante la frase de contraseña especificada por el usuario. Una vez que se descifra el archivo, almacena el contenido 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>

    Puede especificar varios identificadores de servidor mediante separadores de comas.

Opción de ayuda: -?/Help

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

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

Ejemplo de sintaxis:

SSMAforAccessConsole.exe -?

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

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

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

Ejemplo de sintaxis:

SSMAforAccessConsole.exe -securepassword -?

Contenido relacionado

  • Last updated on