Partilhar via

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 SSMA. As secções seguintes fornecem pormenores 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 secção, o termo «opção» é também referido como «interruptor».

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, é obrigatório que você especifique os parâmetros de opção correspondentes.

Os parâmetros de opção devem ser separados do caractere de opção por 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 contenham 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

Uma opção obrigatória, o caminho/nome do arquivo de script especifica o script de sequências de comandos 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 valor variável: -v/variable

O arquivo de valor variável compreende variáveis usadas no arquivo de script. O interruptor é opcional. Se as variáveis não forem declaradas no arquivo variável 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 valor de variável, talvez uma com um valor padrão e outra com um valor específico da instância, quando aplicável. O último arquivo de variável especificado nos argumentos de 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

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

A definição de 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:

  • Os IDs do servidor são usados no arquivo de script. Eles são definidos em um arquivo de conexão de servidor separado. Este 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 está 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]

Este 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 a opção 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 a opção 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 do arquivo de log: -l/log

Todas as operações SSMA no aplicativo Console são registradas em um arquivo de log e o switch é 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

Essa opção 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

Esta opção indica a senha criptografada para conexões de servidor. Ele 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 qualquer outra opção ou senha como o parâmetro de linha de comando. Caso contrário, resulta em um erro. Para obter mais informações, consulte a seção Gerenciando senhas.

As seguintes subopções são suportadas para -p/securepassword:

  • Para adicionar uma senha ou atualizar uma senha existente ao armazenamento protegido para uma ID de Servidor especificada 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 especificada ou para todas as IDs do Servidor:

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

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

    -p/securepassword -l/list

  • Para exportar as palavras-passe armazenadas no armazenamento protegido para um ficheiro encriptado. Este ficheiro foi encriptado com a frase secreta especificada pelo utilizador.

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

  • O arquivo criptografado que foi exportado anteriormente é importado para o armazenamento protegido local usando a senha especificada pelo usuário. Uma vez que o ficheiro é desencriptado, é armazenado num novo ficheiro, que por sua vez, é encriptado na máquina local.

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

    Vários IDs de servidor podem ser especificados usando separadores de vírgula.

Opção de ajuda: -?/Help

Exibe o resumo da 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 SSMA, consulte Apêndice - 1 (AccessToSQL).

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

Exibe o resumo da 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 SSMA, consulte Apêndice - 1 (AccessToSQL)

Próximos passos

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

  1. Para especificar uma senha ou exportar/importar senhas, consulte Gerenciando senhas (AccessToSQL).

  2. Para gerar relatórios, consulte Gerando relatórios (AccessToSQL).

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