Udostępnij za pośrednictwem

Opcje wiersza polecenia w konsoli SSMA (Db2ToSQL)

  • Artykuł

Program SQL Server Migration Assistant (SSMA) udostępnia niezawodny zestaw opcji wiersza polecenia do wykonywania i kontrolowania działań db2. W poniższych sekcjach szczegółowo opisano to samo.

Opcje wiersza polecenia w konsoli SSMA

W tej sekcji opisano opcje poleceń konsoli, znane również jako przełączniki.

Opcje nie rozróżniają wielkości liter i mogą zaczynać się od znaku - lub /.

Jeśli określono opcje, należy określić odpowiednie parametry opcji.

Parametry opcji muszą być oddzielone od znaku opcji białymi znakami.

przykłady składni :

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"

Foldery i nazwy plików zawierające spacje powinny być określone w cudzysłowach podwójnych.

Dane wyjściowe wpisów wiersza polecenia i komunikatów o błędach są przechowywane w stDOUT lub w określonym pliku.

Opcja pliku skryptu: -s | skrypt

Jest to obowiązkowy przełącznik, gdzie ścieżka lub nazwa pliku skryptu określa skrypt sekwencji poleceń, które wykonuje program SSMA.

przykład składni :

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

Opcja wartości zmiennej w pliku: -v | zmienna

Ten plik składa się ze zmiennych używanych w pliku skryptu. Ten przełącznik jest opcjonalny. Jeśli zmienne nie są deklarowane w pliku zmiennej i używane w pliku skryptu, aplikacja generuje błąd i kończy wykonywanie konsoli.

przykład składni:

Zmienne zdefiniowane w wielu plikach wartości zmiennych, być może jeden z wartością domyślną, a drugi z określoną wartością wystąpienia, jeśli ma to zastosowanie. Ostatni plik zmiennej określony w argumentach wiersza polecenia przyjmuje preferencję, w przypadku duplikowania zmiennych:

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"

Opcja pliku połączenia serwera: -c | serwerconnection

Ten plik zawiera informacje o połączeniu serwera dla każdego serwera. Każda definicja serwera jest identyfikowana przez unikatowy identyfikator serwera. Identyfikatory serwera znajdują się w pliku skryptu dla poleceń powiązanych z połączeniem.

Definicja serwera może być częścią pliku połączenia serwera i/lub pliku skryptu. Identyfikator serwera w pliku skryptu ma pierwszeństwo przed plikiem połączenia serwera, w przypadku duplikowania identyfikatora serwera.

przykłady składni :

  • Identyfikatory serwera są używane w pliku skryptu i definiuje się je w osobnym pliku połączenia serwera. Plik połączenia serwera używa zmiennych zdefiniowanych w pliku wartości zmiennej:

    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

  • Definicja serwera jest osadzona w pliku skryptu:

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

Opcja wyjścia XML: -x | xmloutput [ xmloutputfile ]

To polecenie służy do wyprowadzania komunikatów wyjściowych polecenia w formacie XML do konsoli lub pliku XML.

Dostępne są dwie opcje dla xmloutput, na przykład:

  • Jeśli ścieżka pliku zostanie podana po przełączeniu xmloutput, dane wyjściowe są przekierowywane do pliku.

    Przykład składni:

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

  • Jeśli po przełączeniu xmloutput nie zostanie podana żadna ścieżka pliku, xmlout zostanie wyświetlona w samej konsoli programu .

    Przykład składni: 

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

Opcja pliku dziennika: -l | dziennik

Wszystkie operacje SSMA w aplikacji konsolowej są rejestrowane w pliku dziennika. Ten przełącznik jest opcjonalny. Jeśli plik dziennika i jego ścieżka są określone w wierszu polecenia, dziennik zostanie wygenerowany w określonej lokalizacji. W przeciwnym razie jest generowany w domyślnej lokalizacji.

przykład składni :

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

Opcja folderu środowiska projektu: -e | projectenvironment

Określa folder ustawień środowiska projektu dla bieżącego projektu SSMA. Ten przełącznik jest opcjonalny.

Przykład składni:

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

Opcja bezpiecznego hasła: -p | securepassword

Ta opcja wskazuje zaszyfrowane hasło dla połączeń serwera. Różni się ona od wszystkich innych opcji: opcja nie wykonuje żadnego skryptu ani nie pomaga w żadnych działaniach związanych z migracją. Zamiast tego pomaga zarządzać szyfrowaniem haseł dla połączeń serwera używanych w projekcie migracji.

Nie można wprowadzić żadnej innej opcji ani hasła jako parametru wiersza polecenia. W przeciwnym razie spowoduje to wystąpienie błędu. Aby uzyskać więcej informacji, zobacz Zarządzanie hasłami.

W przypadku -p | securepasswordobsługiwane są następujące podopcje:

  • Aby dodać hasło do chronionego magazynowania dla określonego identyfikatora serwera lub dla wszystkich identyfikatorów serwera zdefiniowanych w pliku połączenia serwera. Opcja -overwrite aktualizuje hasło, jeśli już istnieje:

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

  • Aby usunąć zaszyfrowane hasło z zabezpieczonego przechowywania wskazanego identyfikatora serwera lub wszystkich identyfikatorów serwera:

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

  • Aby wyświetlić listę identyfikatorów serwera, dla których hasło jest szyfrowane:

    -p | securepassword -l | list

  • Aby wyeksportować hasła przechowywane w chronionym magazynie do zaszyfrowanego pliku. Ten plik jest zaszyfrowany za pomocą określonego przez użytkownika hasła.

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

  • Zaszyfrowany plik, który został wcześniej wyeksportowany, jest importowany do lokalnego chronionego magazynu przy użyciu frazy hasła określonej przez użytkownika. Po odszyfrowaniu pliku jest on przechowywany w nowym pliku, który z kolei jest szyfrowany na komputerze lokalnym.

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

    Można określić wiele identyfikatorów serwera przy użyciu separatorów przecinków.

Opcja pomocy: -? | Pomoc

Wyświetla podsumowanie składni opcji konsoli SSMA:

SSMAforDb2Console.exe -?

Aby zapoznać się z tabelarycznym wyświetlaniem opcji wiersza polecenia konsoli SSMA, zobacz Dodatek 1: Opcje wiersza polecenia konsoli.

Opcja pomocy SecurePassword: -securepassword -? | Pomoc

Wyświetla podsumowanie składni opcji konsoli SSMA:

SSMAforDb2Console.exe -securepassword -?

Aby zapoznać się z tabelarycznym wyświetlaniem opcji wiersza polecenia konsoli SSMA, zobacz Dodatek 1: Opcje wiersza polecenia konsoli

Powiązana zawartość