Opzioni della riga di comando nella console SSMA (AccessToSQL)

Microsoft offre un solido set di comandi di opzioni della riga di comando per eseguire e controllare le attività SSMA. Le seguenti sezioni forniscono informazioni aggiuntive.

Opzioni della riga di comando nella console SSMA

Di seguito sono descritte le opzioni di comando della console.

Ai fini di questa sezione, il termine 'opzione' viene anche definito 'switch'.

Le opzioni non fanno distinzione tra maiuscole e minuscole e possono iniziare con il carattere '-' o '/'.

Se vengono specificate opzioni, è obbligatorio specificare i parametri opzionali corrispondenti.

I parametri opzionali devono essere separati dal carattere di opzione in base allo spazio vuoto.

Esempi di sintassi:

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"

I nomi di file o cartelle contenenti spazi devono essere specificati tra virgolette doppie.

L'output delle voci della riga di comando e dei messaggi di errore viene archiviato in STDOUT o in un file specificato.

Opzione file di script: -s/script

Uno switch obbligatorio, il percorso/nome del file di script specifica lo script delle sequenze di comandi da eseguire da SSMA.

Esempi di sintassi:

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

Opzione file valore variabile: -v/variable

Il file di valori di variabile comprende le variabili usate nel file di script. Lo switch è facoltativo. Se le variabili non vengono dichiarate nel file di variabile e usate nel file di script, l'applicazione genera un errore e termina l'esecuzione della console.

Esempi di sintassi:

• Variabili definite in più file di valori di variabile, ad esempio uno con un valore predefinito e un altro con un valore specifico dell'istanza, se applicabile. L'ultimo file di variabili specificato negli argomenti della riga di comando accetta la preferenza, nel caso in cui vi sia una duplicazione delle variabili:

  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"

Opzione file di connessione server: -c/serverconnection

Questo file contiene informazioni di connessione server per ogni server. Ogni definizione del server è identificata da un ID server univoco. Gli ID server a cui viene fatto riferimento nel file di script per i comandi correlati alla connessione.

La definizione del server può far parte del file di connessione del server e/o del file di script. L'ID server nel file di script ha la precedenza sul file di connessione del server, nel caso in cui sia presente una duplicazione dell'ID server.

Esempi di sintassi:

• Gli ID server vengono usati nel file di script. Vengono definiti in un file di connessione server separato. Questo file usa variabili definite nel file di valori di variabile:

  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

• La definizione del server è incorporata nel file di script:

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

Opzione di output XML: -x/xmloutput [xmloutputfile]

Questo comando viene usato per l'output dei messaggi di output del comando in un formato xml da console o in un file XML.

Sono disponibili due opzioni per xmloutput, ovvero:

• Se il percorso file viene fornito dopo l'opzione xmloutput, l'output viene reindirizzato al file.

  Esempio di sintassi:

  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 non viene fornito alcun percorso file dopo l'opzione xmloutput, il file xmlout viene visualizzato nella console stessa.

  Esempio di sintassi:

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

Opzione file di resoconto: -l/log

Tutte le operazioni SSMA nell'applicazione console vengono registrate in un file di log e l'opzione è facoltativa. Se nella riga di comando viene specificato un file di log e il relativo percorso, il log viene generato nel percorso specificato. In caso contrario, viene generato nella posizione predefinita.

Esempio di sintassi:

C:\>SSMAforAccessConsole.EXE

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

Opzione cartella ambiente progetto: -e/projectenvironment

Questa opzione facoltativa indica la cartella delle impostazioni dell'ambiente del progetto per il progetto SSMA corrente.

Esempio di sintassi:

C:\>SSMAforAccessConsole.EXE -s

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

Opzione password sicura: -p/securepassword

Questa opzione indica la password crittografata per le connessioni server. Differisce da tutte le altre opzioni in quanto non esegue script o guida in alcuna attività correlata alla migrazione, ma consente di gestire la crittografia delle password per le connessioni server usate nel progetto di migrazione.

Non è possibile immettere altre opzioni o password come parametro della riga di comando. In caso contrario, si verificherà un errore. Per altre informazioni, consulta la sezione Gestione delle password.

Sono supportate le seguenti sostituzioni per -p/securepassword:

• Per aggiungere una password o aggiornare una password esistente, alla risorsa di archiviazione protetta per un ID server specificato o per tutti gli ID server definiti nel file di connessione server:

  -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]

• Per rimuovere la password crittografata dall'archiviazione protetta dell'ID server specificato o per tutti gli ID server:

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

• Per visualizzare un elenco di ID server per cui la password è crittografata:

  -p/securepassword -l/list

• Per esportare le password archiviate nell'archiviazione protetta in un file crittografato. Questo file viene crittografato con una passphrase specificata dall'utente.

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

• Il file crittografato esportato in precedenza viene importato nella risorsa di archiviazione protetta locale usando la passphrase specificata dall'utente. Una volta decrittografato, il file viene archiviato in un nuovo file, che a sua volta viene crittografato nel computer locale.

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

  È possibile specificare più ID server usando separatori di virgole.

Opzione guida: -?/Help

Visualizza il riepilogo della sintassi delle opzioni della console SSMA.

C:\>SSMAforAccessConsole.EXE -?

Per una visualizzazione tabulare delle opzioni della riga di comando della console SSMA, vedere Appendice - 1 (AccessToSQL).

Opzione della Guida SecurePassword: -securepassword -?/Help

Visualizza il riepilogo della sintassi delle opzioni della console SSMA.

C:\>SSMAforAccessConsole.EXE -securepassword -?

Per una visualizzazione tabulare delle opzioni della riga di comando della console SSMA, vedere Appendice - 1 (AccessToSQL).

Passaggi successivi

Il passaggio successivo dipende dai requisiti del progetto:

1. Per specificare una password o esportare/importare password, vedere Gestione delle password (AccessToSQL).

2. Per la generazione di report, vedere Generazione di report (AccessToSQL).

3. Per la risoluzione dei problemi nella console, vedere Risoluzione dei problemi (AccessToSQL).