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

Article
10/22/2024

Assistant Migration SQL Server (SSMA) vous fournit un ensemble robuste d’options de ligne de commande pour exécuter et contrôler les activités Db2. Les sections suivantes les détaillent.

Options de ligne de commande dans la console SSMA

Cette section décrit les options de commande de console, également appelées commutateurs.

Les options ne respectent pas la casse et peuvent commencer par l’un ou l’autre - / caractère.

Si des options sont spécifiées, vous devez spécifier les paramètres d’option correspondants.

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

Exemples de syntaxe :

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ServersConnectionFileSample.xml"

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

La sortie des entrées de ligne de commande et les messages d’erreur sont stockés 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écutées par SSMA.

Exemple de syntaxe :

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

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

Ce fichier comprend des variables utilisées dans le fichier script. Ce 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.

Exemple de syntaxe :

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

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migration projects\global_variablevaluefile.xml -v "C:\migrationprojects\instance_variablevaluefile.xml"

Option de fichier de connexion serveur : -c | serverconnection

Ce fichier contient les informations de connexion au 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 script pour les commandes associées à la connexion.

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

Exemples de syntaxe :

Les ID de serveur sont utilisés dans le fichier de script et vous les définissez dans un fichier de connexion serveur distinct. Le fichier de connexion serveur utilise des variables, qui sont définies dans le fichier de valeur de variable :
```
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\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 script :

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\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, par exemple :

Si le chemin d’accès au fichier est fourni après le xmloutput commutateur, la sortie est redirigée vers le fichier.

Exemple de syntaxe :

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

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

Exemple de syntaxe :

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Option fichier journal : -l | rapport

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

Exemple de syntaxe :

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

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

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

Exemple de syntaxe :

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\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 au serveur. Elle diffère de toutes les autres options : l’option n’exécute aucun script ni 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.

Vous ne pouvez entrer aucune autre option ou mot de passe comme paramètre de ligne de commande. Sinon, cela génère une erreur. Pour plus d’informations, consultez Gérer les mots de passe.

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

Pour ajouter un mot de passe au stockage protégé pour un ID de serveur spécifié ou pour tous les ID de serveur définis dans le fichier de connexion au serveur. L’option -overwrite met à jour le mot de passe s’il existe déjà :

-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 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 console SSMA :

SSMAforDb2Console.exe -?

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

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

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

SSMAforDb2Console.exe -securepassword -?

Pour un affichage tabulaire des options de ligne de commande de la console SSMA, consultez l’Annexe 1 : Options de ligne de commande de la console

Partager via

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