Partilhar via

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

A Microsoft disponibiliza um conjunto robusto de opções de linha de comandos para executar e controlar as atividades do SQL Server Migration Assistant (SSMA). Saiba mais nas seções a seguir.

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

Esta secção descreve as opções de comandos da consola.

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

As opções não são sensíveis a maiúsculas e minúsculas e podem começar com o carácter - ou /.

Se especificar opções, deve também especificar os parâmetros correspondentes das opções.

Tens de separar os parâmetros de opção do carácter de opção usando espaços 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 pastas ou ficheiros que contenham espaços devem ser especificados com aspas duplas.

A saída das entradas da linha de comandos e das mensagens de erro vai para stdout ou para um ficheiro especificado.

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

Use este interruptor obrigatório para especificar o caminho e o nome do ficheiro de script. O ficheiro de script contém sequências de comandos 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/variable

Use este interruptor opcional para especificar um ficheiro de valor variável. O ficheiro contém variáveis usadas no ficheiro de script. Se o ficheiro de script usar variáveis que não são declaradas num ficheiro de valor variável, o SSMA gera um erro e termina a execução na consola.

Exemplo de sintaxe:

Defina variáveis em ficheiros de múltiplas variáveis, como um ficheiro com valores predefinidos e outro com valores específicos da instância. Se houver duplicação de variáveis, o último ficheiro de variáveis especificado nos argumentos da linha de comandos 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

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 único. O ficheiro script faz referência a cada ID de servidor em comandos relacionados com a ligação.

Uma definição de servidor pode fazer parte de um ficheiro de ligação ao servidor ou de um ficheiro de script. Se houver duplicação do ID do servidor, o ID do servidor do ficheiro de script tem prioridade sobre o ficheiro de ligação ao servidor.

Exemplos de sintaxe:

  • Use IDs de servidor no ficheiro de script e defina-os num ficheiro de ligação de servidor separado. Este arquivo usa variáveis que são definidas no arquivo de valor da 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

  • Incorpore a definição do servidor no ficheiro 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 este comando para enviar as mensagens de saída dos comandos em formato XML, seja para a consola ou para um ficheiro XML.

xmloutput tem duas opções.

  • Se forneceres o caminho do ficheiro após a xmloutput troca, redireciona a saída para o ficheiro.

    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 não fornecer um caminho de ficheiro após a xmloutput troca, a saída é exibida na consola.

    Exemplo de sintaxe:

    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

A aplicação Consola regista todas as operações SSMA num ficheiro de registo. O interruptor é opcional. Se especificar um ficheiro de registo e o seu caminho na linha de comandos, o registo é gerado na localização especificada. Caso contrário, o registo é gerado na sua localização predefinida.

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

Use este interruptor opcional para especificar a pasta de definiçõ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 esta opção para especificar a palavra-passe encriptada para as ligações ao servidor. Difere de todas as outras opções porque não executa qualquer script nem ajuda em atividades relacionadas com migração. Em vez disso, ajuda a gerir a encriptação das palavras-passe para as ligações ao servidor utilizadas no projeto de migração.

Quando usa esta opção, deve ser o único parâmetro que fornece. Quaisquer outras opções ou palavras-passe fazem o comando falhar. Para mais informações, consulte a secção Gerir palavras-passe .

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

  • Adicione ou atualize uma palavra-passe em armazenamento protegido para um ID de servidor especificado, ou para todos os IDs de servidor definidos no ficheiro de ligação ao 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]

  • Remover a palavra-passe encriptada do armazenamento protegido do ID do servidor especificado ou para todos os IDs do servidor:

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

  • Mostrar uma lista de IDs de servidor para os quais a palavra-passe está encriptada:

    -p/securepassword -l/list

  • Exporte as palavras-passe armazenadas em armazenamento protegido para um ficheiro encriptado. Este ficheiro é encriptado com a palavra-passe especificada pelo utilizador.

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

  • O ficheiro encriptado anteriormente exportado é importado para armazenamento protegido local, usando a palavra-passe especificada pelo utilizador. Depois de desencriptado, o ficheiro armazena o conteúdo num novo ficheiro, que por sua vez é encriptado na máquina local.

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

    Pode especificar múltiplos IDs de servidor usando separadores de vírgula.

Opção de ajuda: -?/Help

Mostra o resumo sintático das opções da Consola SSMA.

Para uma visualização tabular das opções de linha de comandos da Consola SSMA, veja o Apêndice - 1.

Exemplo de sintaxe:

SSMAforAccessConsole.exe -?

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

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

Para uma visualização tabular das opções de linha de comandos da Consola SSMA, veja o Apêndice - 1.

Exemplo de sintaxe:

SSMAforAccessConsole.exe -securepassword -?

Conteúdo relacionado

  • Last updated on