Partager via

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

Microsoft fournit un ensemble robuste d’options de ligne de commande pour exécuter et contrôler les activités de l’Assistant Migration SQL Server (SSMA). En savoir plus dans les sections suivantes.

Options de ligne de commande dans la console SSMA

Cette section décrit les options de commande de console.

Dans cette section, les termes option et commutateur désignent la même chose.

Les options ne sont pas sensibles à la casse et peuvent commencer par le caractère - ou /.

Si vous spécifiez des options, vous devez également spécifier les paramètres d’option correspondants.

Vous devez séparer les paramètres d’option du caractère d’option à l’aide d’un espace blanc.

Exemples de syntaxe :

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"

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

La sortie des entrées de ligne de commande et des messages d’erreur est envoyée à stdout ou à un fichier spécifié.

Option de fichier de script : -s/script

Utilisez ce commutateur obligatoire pour spécifier le chemin et le nom du fichier de script. Le fichier de script contient des séquences de commandes exécutées par SSMA.

Exemple de syntaxe :

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

Utilisez ce commutateur facultatif pour spécifier un fichier de valeur de variable. Le fichier contient des variables utilisées dans le fichier de script. Si le fichier de script utilise des variables qui ne sont pas déclarées dans un fichier de valeur de variable, SSMA génère une erreur et met fin à l’exécution de la console.

Exemple de syntaxe :

Définissez des variables dans plusieurs fichiers de valeurs de variable, tels qu’un fichier avec des valeurs par défaut et un autre fichier avec des valeurs spécifiques à l’instance. S’il existe une duplication de variables, le dernier fichier de variables spécifié dans les arguments de ligne de commande prend la préférence :

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"

Option de fichier de connexion serveur : -c/serverconnection

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

Une définition de serveur peut faire partie d’un fichier de connexion de serveur ou d’un fichier de script. S’il existe une duplication de l’ID de serveur, l’ID du serveur de fichiers de script est prioritaire sur le fichier de connexion du serveur.

Exemples de syntaxe :

  • Utilisez les ID de serveur dans le fichier de script et définissez-les dans un fichier de connexion de serveur distinct. Ce fichier utilise des variables définies dans le fichier de valeur de variable :

    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

  • Incorporez la définition du serveur dans le fichier de script :

    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]

Utilisez cette commande pour générer les messages de sortie de commande dans un format XML, soit dans la console, soit dans un fichier XML.

xmloutput a deux options.

  • Si vous fournissez le chemin d’accès du fichier après l’option xmloutput, alors redirigez la sortie vers le fichier.

    Exemple de syntaxe :

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

  • Si vous ne fournissez pas de chemin de fichier après l'option xmloutput, la sortie s'affiche sur la console.

    Exemple de syntaxe :

    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

L’application console enregistre toutes les opérations SSMA dans un fichier journal. Le commutateur est facultatif. Si vous spécifiez un fichier journal et son chemin d’accès à la ligne de commande, le journal est généré à l’emplacement spécifié. Sinon, le journal est généré à son emplacement par défaut.

Exemple de syntaxe :

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

Option de dossier d’environnement de projet : -e/projectenvironment

Utilisez ce commutateur facultatif pour spécifier le dossier des paramètres d’environnement du projet SSMA actuel.

Exemple de syntaxe :

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

Utilisez cette option pour spécifier le mot de passe chiffré pour les connexions de serveur. Elle diffère de toutes les autres options dans le fait qu’elle n’exécute aucun script ni aucune aide dans les activités liées à la migration. Au lieu de cela, il permet de gérer le chiffrement de mot de passe pour les connexions serveur utilisées dans le projet de migration.

Lorsque vous utilisez cette option, il doit s’agir du seul paramètre que vous fournissez. Toutes les autres options ou mots de passe entraînent l’échec de la commande. Pour plus d’informations, consultez la section Gérer les mots de passe .

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

  • Ajoutez ou mettez à jour un mot de passe dans le stockage protégé pour 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]

  • Supprimez 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}

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

    -p/securepassword -l/list

  • Exportez 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é précédemment exporté 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 stocke le contenu dans un nouveau fichier, qui à son tour est chiffré sur l’ordinateur local.

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

    Vous pouvez spécifier plusieurs ID de serveur à l’aide de séparateurs de virgules.

Option d’aide : - ?/Aide

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

Pour obtenir un affichage tabulaire des options de ligne de commande de la console SSMA, consultez l’annexe 1.

Exemple de syntaxe :

SSMAforAccessConsole.exe -?

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

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

Pour obtenir un affichage tabulaire des options de ligne de commande de la console SSMA, consultez l’annexe 1.

Exemple de syntaxe :

SSMAforAccessConsole.exe -securepassword -?

Contenu connexe

  • Last updated on