Options de ligne de commande dans la console SSMA (AccessToSQL)

Microsoft vous fournit un ensemble robuste d’options de ligne de commande pour exécuter et contrôler les activités SSMA. Les sections suivantes fournissent des détails supplémentaires.

Options de ligne de commande dans la console SSMA

Les options de commande de la console sont décrites ici.

Dans le cadre de cette section, le terme « option » est également appelé « commutateur ».

Les options ne respectent pas la casse et peuvent commencer par le caractère «- » ou «/ ».

Si des options sont spécifiées, il est obligatoire de spécifier les paramètres d’option correspondants.

Les paramètres d’option doivent être séparés du caractère d’option par espace blanc.

Exemples de syntaxe :

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"

Les noms de dossiers ou de fichiers contenant des espaces doivent être spécifiés entre guillemets doubles.

La sortie des entrées de ligne de commande et des messages d’erreur est stockée dans STDOUT ou dans un fichier spécifié.

Option de fichier de script : -s/script

Un commutateur obligatoire, le chemin/le nom du fichier de script spécifie le script des séquences de commandes à exécuter par SSMA.

Exemples de syntaxe :

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

Option de fichier de valeur de variable : -v/variable

Le fichier de valeur de variable comprend des variables utilisées dans le fichier de script. Le commutateur est facultatif. Si les variables ne sont pas déclarées dans le fichier de variable et utilisées dans le fichier de script, l’application génère une erreur et met fin à l’exécution de la console.

Exemples de syntaxe :

  • Variables définies dans plusieurs fichiers de valeurs de variable, peut-être une avec une valeur par défaut et une autre avec une valeur spécifique à l’instance, le cas échéant. Le dernier fichier de variable spécifié dans les arguments de ligne de commande prend la préférence, au cas où il existe une duplication de variables :

    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"

Option de fichier de connexion de serveur : -c/serverconnection

Ce fichier contient des informations de connexion de serveur pour chaque serveur. Chaque définition de serveur est identifiée par un ID de serveur unique. Les ID de serveur sont référencés dans le fichier de script pour les commandes liées à la connexion.

La définition de serveur peut faire partie du fichier de connexion de serveur et/ou du fichier de script. L’ID de serveur dans le fichier de script est prioritaire sur le fichier de connexion du serveur, en cas de duplication de l’ID de serveur.

Exemples de syntaxe :

  • Les ID de serveur sont utilisés dans le fichier de script. Ils sont définis dans un fichier de connexion de serveur distinct. Ce fichier utilise des variables définies dans le fichier de valeur de variable :

    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 définition du serveur est incorporée dans le fichier de script :

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

Option de sortie XML : -x/xmloutput [xmloutputfile]

Cette commande est utilisée pour sortir les messages de sortie de commande dans un format XML dans la console ou dans un fichier xml.

Il existe deux options disponibles pour xmloutput, à savoir :

  • Si le chemin de fichier est fourni après le commutateur xmloutput, la sortie est redirigée vers le fichier.

    Exemple de syntaxe :

    C:\>SSMAforAccessConsole.EXE -s

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

  • Si aucun chemin de fichier n’est fourni après le commutateur xmloutput, le xmlout s’affiche sur la console elle-même.

    Exemple de syntaxe :

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

Option de fichier journal : -l/log

Toutes les opérations SSMA dans l’application console sont enregistrées dans un fichier journal, et le commutateur est facultatif. Si un fichier journal et son chemin d’accès sont spécifiés à la ligne de commande, le journal est généré à l’emplacement spécifié. Sinon, elle est générée à son emplacement par défaut.

Exemple de syntaxe :

C:\>SSMAforAccessConsole.EXE

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

Project’option de dossier d’environnement : -e/projectenvironment

Ce commutateur facultatif indique le dossier des paramètres d’environnement du projet pour le projet SSMA actuel.

Exemple de syntaxe :

C:\>SSMAforAccessConsole.EXE -s

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

Option de mot de passe sécurisé : -p/securepassword

Cette option indique le mot de passe chiffré pour les connexions serveur. Elle diffère de toutes les autres options en ce qu’elle n’exécute pas de script ni d’aide dans les activités liées à la migration, mais permet de gérer le chiffrement de mot de passe pour les connexions serveur utilisées dans le projet de migration.

Vous ne pouvez pas entrer d’autre option ou mot de passe en tant que paramètre de ligne de commande. Sinon, cela entraîne une erreur. Pour plus d’informations, consultez la section Gestion des mots de passe .

Les sous-options suivantes sont prises en charge pour -p/securepassword:

  • Pour ajouter un mot de passe ou mettre à jour un mot de passe existant, pour protéger le stockage d’un ID de serveur spécifié ou pour tous les ID de serveur définis dans le fichier de connexion du serveur :

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

  • Pour supprimer le mot de passe chiffré du stockage protégé de l’ID de serveur spécifié ou pour tous les ID de serveur :

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

  • Pour afficher la liste des ID de serveur pour lesquels le mot de passe est chiffré :

    -p/securepassword -l/list

  • Pour exporter les mots de passe stockés dans un stockage protégé vers un fichier chiffré. Ce fichier est chiffré avec la phrase secrète spécifiée par l’utilisateur.

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

  • Le fichier chiffré qui a été exporté précédemment est importé dans le stockage protégé local à l’aide de la phrase secrète spécifiée par l’utilisateur. Une fois le fichier déchiffré, il est stocké dans un nouveau fichier, qui à son tour est chiffré sur l’ordinateur local.

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

    Plusieurs ID de serveur peuvent être spécifiés à l’aide de séparateurs de virgules.

Option d’aide : -?/Aide

Affiche le résumé de la syntaxe des options de la console SSMA :

C:\>SSMAforAccessConsole.EXE -?

Pour obtenir un affichage tabulaire des options de ligne de commande de la console SSMA, reportez-vous à l’annexe 1 (AccessToSQL).

Option d’aide SecurePassword : -securepassword -?/Help

Affiche le résumé de la syntaxe des options de la console SSMA :

C:\>SSMAforAccessConsole.EXE -securepassword -?

Pour obtenir un affichage tabulaire des options de ligne de commande de la console SSMA, reportez-vous à l’Annexe - 1 (AccessToSQL)

Étapes suivantes

L’étape suivante dépend des besoins de votre projet :

  1. Pour spécifier un mot de passe ou exporter/importer des mots de passe, consultez Gestion des mots de passe (AccessToSQL).

  2. Pour générer des rapports, consultez Génération de rapports (AccessToSQL).

  3. Pour résoudre les problèmes dans la console, consultez Résolution des problèmes (AccessToSQL)