Freigeben über

Befehlszeilenoptionen in der SSMA-Konsole (Db2ToSQL)

  • Artikel

Der SQL Server-Migrations-Assistent (SSMA) bietet Ihnen einen robusten Satz von Befehlszeilenoptionen zum Ausführen und Steuern von Db2-Aktivitäten. In den folgenden Abschnitten wird dies näher erläutert.

Befehlszeilenoptionen in der SSMA-Konsole

In diesem Abschnitt werden die Konsolenbefehlsoptionen beschrieben, auch als Schalter bezeichnet.

Bei Optionen wird die Groß-/Kleinschreibung nicht beachtet und kann mit einem oder einem - Zeichen / beginnen.

Wenn Optionen angegeben sind, müssen Sie die entsprechenden Optionsparameter angeben.

Optionsparameter müssen durch Leerzeichen vom Optionszeichen getrennt werden.

Syntaxbeispiele:

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"

Ordner und Dateinamen, die Leerzeichen enthalten, sollten in doppelten Anführungszeichen angegeben werden.

Die Ausgabe von Befehlszeileneinträgen und Fehlermeldungen wird in STDOUT oder in einer angegebenen Datei gespeichert.

Skriptdateioption: -s | Skript

Ein obligatorischer Switch, der Skriptdateipfad/-name gibt das Skript von Befehlssequenzen an, die SSMA ausführt.

Syntaxbeispiel:

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

Variable Wert Dateioption: -v | Variable

Diese Datei besteht aus Variablen, die in der Skriptdatei verwendet werden. Dieser Schalter ist optional. Wenn Variablen nicht in der Variablendatei deklariert und in der Skriptdatei verwendet werden, generiert die Anwendung einen Fehler und beendet die Konsolenausführung.

Syntaxbeispiel:

Variablen, die in mehreren Variablenwertdateien definiert sind, vielleicht eine mit einem Standardwert und eine andere mit einem instanzspezifischen Wert, falls zutreffend. Die letzte variable Datei, die in den Befehlszeilenargumenten angegeben ist, verwendet die Einstellung, falls eine Duplizierung von Variablen vorhanden ist:

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"

Serververbindungsdateioption: -c | serverconnection

Diese Datei enthält Serververbindungsinformationen für jeden Server. Jede Serverdefinition wird durch eine eindeutige Server-ID identifiziert. Auf die Server-IDs wird in der Skriptdatei für verbindungsbezogene Befehle verwiesen.

Die Serverdefinition kann Teil der Serververbindungsdatei und/oder Skriptdatei sein. Die Server-ID in der Skriptdatei hat Vorrang vor der Serververbindungsdatei, falls eine Duplizierung der Server-ID vorhanden ist.

Syntaxbeispiele:

  • Server-IDs werden in der Skriptdatei verwendet und in einer separaten Serververbindungsdatei definiert. Die Serververbindungsdatei verwendet Variablen, die in der Variablenwertdatei definiert sind:

    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

  • Die Serverdefinition ist in die Skriptdatei eingebettet:

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

XML-Ausgabeoption: -x | xmloutput [ xmloutputfile ]

Dieser Befehl wird zum Ausgeben der Befehlsausgabemeldungen in einem XML-Format verwendet, entweder in konsolen oder in einer XML-Datei.

Es stehen zwei Optionen zur Verfügung xmloutput, z. B.:

  • Wenn der Dateipfad nach dem xmloutput Switch bereitgestellt wird, wird die Ausgabe an die Datei umgeleitet.

    Syntaxbeispiel:

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

  • Wenn nach der xmloutput Option kein Dateipfad bereitgestellt wird, wird die xmlout Datei auf der Konsole selbst angezeigt.

    Syntaxbeispiel:

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

Protokolldateioption: -l | Log

Alle SSMA-Vorgänge in der Konsolenanwendung werden in einer Protokolldatei aufgezeichnet. Dieser Schalter ist optional. Wenn eine Protokolldatei und ihr Pfad in der Befehlszeile angegeben werden, wird das Protokoll an dem angegebenen Ort erstellt. Andernfalls wird sie an ihrem Standardspeicherort generiert.

Syntaxbeispiel:

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

Projektumgebungsordneroption: -e | Projectenvironment

Gibt den Ordner "Projektumgebungseinstellungen" für das aktuelle SSMA-Projekt an. Dieser Schalter ist optional.

Syntaxbeispiel:

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

Option für sicheres Kennwort: -p | securepassword

Diese Option gibt das verschlüsselte Passwort für Serververbindungen an. Es unterscheidet sich von allen anderen Optionen: Die Option führt kein Skript aus oder hilft bei migrationsbezogenen Aktivitäten. Stattdessen hilft es, die Kennwortverschlüsselung für die Serververbindungen zu verwalten, die im Migrationsprojekt verwendet werden.

Sie können keine andere Option oder ein Kennwort als Befehlszeilenparameter eingeben. Andernfalls tritt ein Fehler auf. Weitere Informationen finden Sie unter Verwalten von Kennwörtern.

Die folgenden Unteroptionen werden unterstützt für -p | securepassword:

  • So fügen Sie dem geschützten Speicher ein Passwort für eine bestimmte Server-ID oder für alle in der Serververbindungsdatei definierten Server-IDs hinzu. Die -overwrite Option aktualisiert das Kennwort, wenn es bereits vorhanden ist:

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

  • So entfernen Sie das verschlüsselte Passwort aus dem geschützten Speicher der angegebenen Server-ID oder für alle Server-IDs:

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

  • So zeigen Sie eine Liste der Server-IDs an, für die das Passwort verschlüsselt ist:

    -p | securepassword -l | list

  • So exportieren Sie die im geschützten Speicher gespeicherten Passwörter in eine verschlüsselte Datei. Diese Datei wird mit der vom Benutzer angegebenen Passphrase verschlüsselt.

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

  • Die verschlüsselte Datei, die zuvor exportiert wurde, wird unter Verwendung der vom Benutzer angegebenen Passphrase in den lokalen geschützten Speicher importiert. Sobald die Datei entschlüsselt wurde, wird sie in einer neuen Datei gespeichert, die wiederum auf dem lokalen Computer verschlüsselt ist.

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

    Mehrere Server-IDs können mithilfe von Kommatrennzeichen angegeben werden.

Hilfeoption: -? | Hilfe

Zeigt die Syntaxzusammenfassung der SSMA-Konsolenoptionen an:

SSMAforDb2Console.exe -?

Eine tabellarische Anzeige der Befehlszeilenoptionen der SSMA-Konsole finden Sie in Anhang 1: Befehlszeilenoptionen der Konsole.

SecurePassword-Hilfeoption: -securepassword -? | Hilfe

Zeigt die Syntaxzusammenfassung der SSMA-Konsolenoptionen an:

SSMAforDb2Console.exe -securepassword -?

Eine tabellarische Anzeige der Befehlszeilenoptionen der SSMA-Konsole finden Sie in Anhang 1: Befehlszeilenoptionen der Konsole

Zugehöriger Inhalt