Freigeben über

Befehlszeilenoptionen in der SSMA-Konsole (SybaseToSQL)

  • Artikel

Microsoft bietet Ihnen einen robusten Satz von Befehlszeilenoptionen zum Ausführen und Steuern von SSMA-Aktivitäten. In den folgenden Abschnitten wird das gleiche detailiert.

Befehlszeilenoptionen in der SSMA-Konsole

Im Folgenden werden die Konsolenbefehlsoptionen beschrieben.

Für diesen Abschnitt wird der Begriff "Option" auch als "Switch" bezeichnet.

  • Bei Optionen wird die Groß-/Kleinschreibung nicht beachtet, und sie kann entweder mit "-" oder "/" beginnen.

  • Wenn Optionen angegeben werden, ist es obligatorisch, die entsprechenden Optionsparameter anzugeben.

  • Optionsparameter müssen durch Leerzeichen vom Optionszeichen getrennt werden.

    Syntaxbeispiele:

    C:\> SSMAforSybaseConsole.EXE -s scriptfile

    C:\> SSMAforSybaseConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\Sample Console Scripts\ServersConnectionFileSample.xml"

  • Ordner- oder 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/script

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

Syntaxbeispiele:

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

Variable Value File Option: -v/variable

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

Syntaxbeispiele:

  • Variablen, die in mehreren Variablenwertdateien definiert sind, z. B. eines mit einem Standardwert und einem anderen 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:

    C:\>SSMAforSybaseConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Sybase\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. Serververbindungsdatei verwendet Variablen, die in der Variablenwertdatei definiert sind:

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

    c:\SsmaProjects\myvaluefile1.xml -c

    c:\SsmaProjects\myserverconnectionsfile1.xml

  • Die Serverdefinition ist in die Skriptdatei eingebettet:

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

XML-Ausgabeoption: -x/xmloutput [xmloutputfile]

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

Es gibt zwei Optionen für xmloutput, viz..,:

  • Wenn der Dateipfad nach dem Xmloutput-Schalter bereitgestellt wird, wird die Ausgabe an die Datei umgeleitet.

    Syntaxbeispiel:

    C:\>SSMAforSybaseConsole.EXE -s

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

  • Wenn nach der Xmloutput-Option kein Dateipfad bereitgestellt wird, wird das XML-Element auf der Konsole selbst angezeigt.

    Syntaxbeispiel:

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

Protokolldateioption: -l/log

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

Syntaxbeispiel:

C:\>SSMAforSybaseConsole.EXE

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

Projektumgebungsordneroption: -e/projectenvironment

Dadurch wird der Ordner "Projektumgebungseinstellungen" für das aktuelle SSMA-Projekt bezeichnet. Dieser Schalter ist optional.

Syntaxbeispiel:

C:\>SSMAforSybaseConsole.EXE -s

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

Option für sicheres Kennwort: -p/securepassword

Diese Option gibt das verschlüsselte Kennwort für Serververbindungen an. Es unterscheidet sich von allen anderen Optionen: Die Option führt weder skripts noch hilft bei migrationsbezogenen Aktivitäten, hilft aber beim Verwalten der Kennwortverschlüsselung für die Serververbindungen, die im Migrationsprojekt verwendet werden.

Sie können keine andere Option oder ein Kennwort als Befehlszeilenparameter eingeben. Andernfalls führt dies zu einem Fehler. Weitere Informationen finden Sie im Abschnitt "Verwalten von Kennwörtern ".

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

  • So fügen Sie kennwortgeschützten Speicher für eine angegebene Server-ID oder für alle Server-IDs hinzu, die in der Serververbindungsdatei definiert sind. Die Option "-overwrite" unten aktualisiert das Kennwort, sofern 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 Kennwort 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 Kennwort verschlüsselt ist:

    -p/securepassword -l/list

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

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

  • Die zuvor exportierte verschlüsselte Datei wird mithilfe des vom Benutzer angegebenen Passausdrucks 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 Kommastrennzeichen angegeben werden.

Hilfeoption: -?/Hilfe

Zeigt die Syntaxzusammenfassung der SSMA-Konsolenoptionen an:

C:\>SSMAforSybaseConsole.EXE -?

Eine tabellarische Anzeige der Befehlszeilenoptionen der SSMA-Konsole finden Sie in Anhang - 1 (SybaseToSQL).

SecurePassword-Hilfeoption: -securepassword -?/Help

Zeigt die Syntaxzusammenfassung der SSMA-Konsolenoptionen an:

C:\>SSMAforSybaseConsole.EXE -securepassword -?

Eine tabellarische Anzeige der Befehlszeilenoptionen der SSMA-Konsole finden Sie in Anhang - 1 (SybaseToSQL)

Nächster Schritt

Der nächste Schritt hängt von ihren Projektanforderungen ab:

  • Informationen zum Angeben eines Kennworts oder eines Export-/Importkennworts finden Sie unter Verwalten von Kennwörtern (SybaseToSQL).For specifying a password or export/import passwords, see Managing Passwords (SybaseToSQL).

  • Informationen zum Generieren von Berichten finden Sie unter Generieren von Berichten (SybaseToSQL).

  • Informationen zur Problembehandlung in der Konsole finden Sie unter Problembehandlung (SybaseToSQL).For troubleshooting issues in console, see Troubleshooting (SybaseToSQL).