Opções de linha de comando no console do SSMA (AccessToSQL)

  • Artigo

A Microsoft fornece um conjunto robusto de opções de linha de comando para executar e controlar atividades do SSMA. As seções seguintes fornecem detalhes adicionais.

Opções de linha de comando no console do SSMA

Aqui estão descritas as opções de comando do console.

Para efeitos da presente seção, o termo “opção” é também chamado de “parâmetro”.

As opções não diferenciam maiúsculas de minúsculas e podem começar com o caractere “-” ou “/”.

Se as opções forem especificadas, será obrigatório especificar os parâmetros de opção correspondentes.

Os parâmetros de opção devem ser separados do caractere de opção por um espaço em branco.

Exemplos de sintaxe:

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"

Os nomes de pastas ou arquivos que contêm espaços devem ser especificados entre aspas duplas.

A saída de entradas de linha de comando e mensagens de erro é armazenada em STDOUT ou em um arquivo especificado.

Opção de arquivo de script: -s/script

Um parâmetro obrigatório, o caminho/nome do arquivo de script especifica o script de sequências de comando a serem executadas pelo SSMA.

Exemplos de sintaxe:

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

Opção de arquivo de valores de variáveis: -v/variable

O arquivo de valor de variável compreende variáveis usadas no arquivo de script. Este parâmetro é opcional. Se as variáveis não forem declaradas no arquivo de variáveis e usadas no arquivo de script, o aplicativo gerará um erro e encerrará a execução do console.

Exemplos de sintaxe:

  • Variáveis definidas em vários arquivos de valores de variáveis, talvez um com um valor padrão e outro com um valor específico da instância, quando aplicável. O último arquivo de variável especificado nos argumentos da linha de comando tem a preferência caso haja uma duplicação de variáveis:

    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"

Opção de arquivo de conexão do servidor: -c/serverconnection

Esse arquivo contém informações de conexão do servidor para cada servidor. Cada definição de servidor é identificada por uma ID de servidor exclusiva. As IDs de servidor são referenciadas no arquivo de script para comandos relacionados à conexão.

A definição do servidor pode fazer parte do arquivo de conexão do servidor e/ou do arquivo de script. A ID do servidor no arquivo de script tem precedência sobre o arquivo de conexão do servidor caso haja uma duplicação da ID do servidor.

Exemplos de sintaxe:

  • As IDs de servidor são usadas no arquivo de script. Elas são definidas em um arquivo de conexão de servidor separado. Esse arquivo usa variáveis que são definidas no arquivo de valor da variável:

    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

  • A definição do servidor é incorporada no arquivo de script:

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

Opção de saída XML: -x/xmloutput [xmloutputfile]

Esse comando é usado para enviar as mensagens de saída do comando em um formato xml para o console ou para um arquivo xml.

Há duas opções disponíveis para xmloutput, a saber:

  • Se o caminho do arquivo for fornecido após o parâmetro xmloutput, a saída será redirecionada para o arquivo.

    Exemplo de sintaxe:

    C:\>SSMAforAccessConsole.EXE -s

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

  • Se nenhum caminho de arquivo for fornecido após o parâmetro xmloutput, o xmlout será exibido no próprio console.

    Exemplo de sintaxe:

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

Opção de arquivo de log: -l/log

Todas as operações do SSMA no aplicativo Console são registradas em um arquivo de log e o parâmetro é opcional. Se um arquivo de log e seu caminho forem especificados na linha de comando, o log será gerado no local especificado. Caso contrário, ele será gerado em seu local padrão.

Exemplo de sintaxe:

C:\>SSMAforAccessConsole.EXE

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

Opção de pasta do ambiente do projeto: -e/projectenvironment

Esse parâmetro opcional indica a pasta de configurações do ambiente do projeto para o projeto SSMA atual.

Exemplo de sintaxe:

C:\>SSMAforAccessConsole.EXE -s

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

Opção de senha segura: -p/securepassword

Essa opção indica a senha criptografada para conexões de servidor. Ela difere de todas as outras opções porque não executa nenhum script ou ajuda em nenhuma atividade relacionada à migração, mas ajuda a gerenciar a criptografia de senha para as conexões de servidor usadas no projeto de migração.

Não é possível inserir outra opção ou senha como parâmetro da linha de comando. Caso contrário, isso resultará em um erro. Para obter mais informações, confira a seção Gerenciar senhas.

As seguintes subopções são compatíveis com -p/securepassword:

  • Para adicionar uma senha, ou atualizar uma existente, ao armazenamento protegido para uma ID de servidor específica ou para todas as IDs de servidor definidas no arquivo de conexão do 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 remover a senha criptografada do armazenamento protegido da ID do servidor específica ou para todas as IDs de servidor:

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

  • Para exibir uma lista de IDs de servidor para as quais a senha é criptografada:

    -p/securepassword -l/list

  • Para exportar as senhas salvas no armazenamento protegido para um arquivo criptografado. Este arquivo está criptografado com a senha especificada pelo usuário.

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

  • O arquivo criptografado, exportado anteriormente, é importado para o armazenamento local protegido usando a senha especificada pelo usuário. Uma vez que o arquivo é descriptografado, ele é armazenado em um novo arquivo, que, por sua vez, é criptografado no computador local.

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

    Várias IDs de servidor podem ser especificadas usando separadores de vírgula.

Opção de ajuda: -?/Ajuda

Exibe o resumo de sintaxe das opções do console do SSMA:

C:\>SSMAforAccessConsole.EXE -?

Para obter uma exibição tabular das opções de linha de comando do console do SSMA, consulte o Apêndice - 1 (AccessToSQL).

Opção de ajuda do SecurePassword: -securepassword -?/Help

Exibe o resumo de sintaxe das opções do console do SSMA:

C:\>SSMAforAccessConsole.EXE -securepassword -?

Para obter uma exibição tabular das opções de linha de comando do console do SSMA, consulte o Apêndice - 1 (AccessToSQL).

Próximas etapas

A próxima etapa depende dos requisitos do seu projeto:

  1. Para especificar uma senha ou exportar/importar senhas, confira Gerenciar senhas (AccessToSQL).

  2. Para gerar relatórios, confira Gerar relatórios (AccessToSQL)..

  3. Para solucionar problemas no console, confira Solução de problemas (AccessToSQL).