Compartilhar via

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

A Microsoft fornece um conjunto robusto de opções de linha de comando para executar e controlar as atividades do SSMA (Assistente de Migração do SQL Server). Saiba mais nas seções a seguir.

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

Esta seção descreve as opções de comando do console.

Nesta seção, os termos opção e switch referem-se à mesma coisa.

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

Se você especificar opções, também deverá especificar os parâmetros de opção correspondentes.

Você deve separar parâmetros de opção do caractere de opção usando espaço em branco.

Exemplos de sintaxe:

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"

Nomes de pasta ou arquivo que contêm espaços devem ser especificados com aspas duplas.

A saída de entradas de linha de comando e mensagens de erro vai para stdout ou para um arquivo especificado.

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

Use essa opção obrigatória para especificar o caminho e o nome do arquivo de script. O arquivo de script contém sequências de comando que o SSMA executa.

Exemplo de sintaxe:

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/variável

Use essa opção opcional para especificar um arquivo de valor variável. O arquivo contém variáveis usadas no arquivo de script. Se o arquivo de script usar variáveis que não são declaradas em um arquivo de valor variável, o SSMA gerará um erro e encerrará a execução do console.

Exemplo de sintaxe:

Defina variáveis em vários arquivos de valor variável, como um arquivo com valores padrão e outro arquivo com valores específicos da instância. Se houver uma duplicação de variáveis, o último arquivo de variável especificado nos argumentos de linha de comando tem preferência:

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"

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

Esse arquivo contém informações de conexão de servidor para cada servidor. Cada definição de servidor é identificada por uma ID de servidor exclusiva. O arquivo de script faz referência a cada ID do servidor em comandos relacionados à conexão.

Uma definição de servidor pode fazer parte de um arquivo de conexão de servidor ou de um arquivo de script. Se houver uma duplicação da ID do servidor, a ID do servidor de arquivos de script terá precedência sobre o arquivo de conexão do servidor.

Exemplos de sintaxe:

  • Use IDs de servidor no arquivo de script e defina-as em um arquivo de conexão de servidor separado. Esse arquivo usa variáveis definidas no arquivo de valor variável:

    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

  • Insira a definição do servidor no arquivo de script:

    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]

Use esse comando para gerar as mensagens de saída de comando em um formato XML, no console ou em um arquivo XML.

xmloutput tem duas opções.

  • Se você fornecer o caminho do arquivo após a opção xmloutput, a saída será redirecionada para o arquivo.

    Exemplo de sintaxe:

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

  • Se você não fornecer um caminho de arquivo após a opção xmloutput , a saída será exibida no console.

    Exemplo de sintaxe:

    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

O aplicativo console registra todas as operações SSMA em um arquivo de log. O interruptor é opcional. Se você especificar um arquivo de log e seu caminho na linha de comando, o log será gerado no local especificado. Caso contrário, o log será gerado em seu local padrão.

Exemplo de sintaxe:

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 de ambiente do projeto: -e/projectenvironment

Use essa opção opcional para especificar a pasta de configurações do ambiente do projeto para o projeto SSMA atual.

Exemplo de sintaxe:

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

Use essa opção para especificar a senha criptografada para conexões de servidor. Ela difere de todas as outras opções, pois não executa nenhum script ou ajuda em nenhuma atividade relacionada à migração. Em vez disso, ajuda a gerenciar a criptografia de senha para as conexões de servidor usadas no projeto de migração.

Quando você usa essa opção, ele deve ser o único parâmetro que você fornece. Quaisquer outras opções ou senhas fazem com que o comando falhe. Para obter mais informações, consulte a seção Gerenciar senhas .

Há suporte para as seguintes suboperações para -p/securepassword:

  • Adicione ou atualize uma senha no 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]

  • Remova a senha criptografada do armazenamento protegido da ID do servidor especificada ou de todas as IDs do servidor:

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

  • Exiba uma lista de IDs do servidor para as quais a senha é criptografada:

    -p/securepassword -l/list

  • Exporte as senhas armazenadas no armazenamento protegido para um arquivo criptografado. Esse arquivo é criptografado com a frase secreta especificada pelo usuário.

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

  • O arquivo criptografado exportado anteriormente é importado para o armazenamento protegido local, usando a frase secreta especificada pelo usuário. Depois que o arquivo é descriptografado, ele armazena o conteúdo em um novo arquivo, que, por sua vez, é criptografado no computador local.

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

    Você pode especificar várias IDs de servidor usando separadores de vírgula.

Opção de ajuda: -?/Ajuda

Exibe o resumo da sintaxe das opções do Console SSMA.

Para obter uma exibição tabular das opções de linha de comando do Console SSMA, consulte Apêndice – 1.

Exemplo de sintaxe:

SSMAforAccessConsole.exe -?

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

Exibe o resumo da sintaxe das opções do Console do SSMA:

Para obter uma exibição tabular das opções de linha de comando do Console SSMA, consulte Apêndice – 1.

Exemplo de sintaxe:

SSMAforAccessConsole.exe -securepassword -?

Conteúdo relacionado

  • Last updated on