Udostępnij przez

Opcje wiersza polecenia w konsoli SSMA (AccessToSQL)

Firma Microsoft udostępnia niezawodny zestaw opcji wiersza polecenia do wykonywania i kontrolowania działań programu SQL Server Migration Assistant (SSMA). Dowiedz się więcej w poniższych sekcjach.

Opcje wiersza polecenia w konsoli SSMA

W tej sekcji opisano opcje poleceń konsoli.

W tej sekcji terminy opcja i przełączenie odnoszą się do tej samej rzeczy.

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

Jeśli określisz opcje, musisz również określić odpowiednie parametry opcji.

Należy oddzielić parametry opcji od znaku opcji przy użyciu odstępu.

Przykłady składni:

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"

Nazwy folderów lub plików zawierających spacje muszą być określone z podwójnymi cudzysłowami.

Dane wyjściowe wpisów wiersza polecenia i komunikatów o błędach są przekazywane do stdout lub do określonego pliku.

Opcja pliku skryptu: -s/script

Użyj tego obowiązkowego przełącznika, aby określić ścieżkę i nazwę pliku skryptu. Plik skryptu zawiera sekwencje poleceń wykonywane przez program SSMA.

Przykład składni:

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

Opcja pliku wartości zmiennej: -v/variable

Użyj tego opcjonalnego przełącznika, aby określić plik wartości zmiennej. Plik zawiera zmienne używane w pliku skryptu. Jeśli plik skryptu używa zmiennych, które nie są zadeklarowane w pliku wartości zmiennej, program SSMA generuje błąd i kończy wykonywanie konsoli.

Przykład składni:

Zdefiniuj zmienne w wielu plikach wartości zmiennych, takich jak jeden plik z wartościami domyślnymi, a drugi plik z wartościami specyficznymi dla wystąpienia. Jeśli występuje duplikacja zmiennych, ostatni plik zmiennej określony w argumentach wiersza polecenia przyjmuje preferencje:

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"

Opcja połączenia z serwerem w pliku: -c/serverconnection

Ten plik zawiera informacje o połączeniu serwera dla każdego serwera. Każda definicja serwera jest identyfikowana przez unikatowy identyfikator serwera. Plik skryptu odwołuje się do każdego identyfikatora serwera w poleceniach związanych z połączeniem.

Definicja serwera może być częścią pliku połączenia serwera lub pliku skryptu. Jeśli istnieje duplikacja identyfikatora serwera, identyfikator serwera z pliku skryptu ma pierwszeństwo przed plikiem połączenia serwera.

Przykłady składni:

  • Użyj identyfikatorów serwera w pliku skryptu i zdefiniuj je w osobnym pliku połączenia serwera. Ten plik używa zmiennych zdefiniowanych w pliku wartości zmiennej:

    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

  • Osadź definicję serwera w pliku skryptu:

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

Opcja danych wyjściowych XML: -x/xmloutput [xmloutputfile]

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

xmloutput ma dwie opcje.

  • Jeśli podasz ścieżkę pliku po przełączeniu xmloutput, przekieruj dane wyjściowe do pliku.

    Przykład składni:

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

  • Jeśli nie podasz ścieżki pliku po przełączniku xmloutput, dane wyjściowe zostaną wyświetlone na konsoli.

    Przykład składni:

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

Opcja pliku dziennika: -l/log

Aplikacja konsolowa rejestruje wszystkie operacje SSMA w pliku dziennika. Przełącznik jest opcjonalny. Jeśli określisz plik dziennika i jego ścieżkę w wierszu polecenia, dziennik zostanie wygenerowany w określonej lokalizacji. W przeciwnym razie dziennik jest generowany w domyślnej lokalizacji.

Przykład składni:

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

Opcja folderu środowiska projektu: -e/projectenvironment

Użyj tego opcjonalnego przełącznika, aby określić folder ustawień środowiska projektu dla bieżącego projektu SSMA.

Przykład składni:

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

Opcja bezpiecznego hasła: -p/securepassword

Użyj tej opcji, aby określić zaszyfrowane hasło dla połączeń serwera. Różni się on od wszystkich innych opcji, ponieważ nie wykonuje żadnych skryptów 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.

Jeśli używasz tej opcji, musi być jedynym parametrem, który podajesz. Wszelkie inne opcje lub hasła powodują niepowodzenie polecenia. Aby uzyskać więcej informacji, zobacz sekcję Zarządzanie hasłami .

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

  • Dodaj lub zaktualizuj hasło w magazynie chronionym dla określonego identyfikatora serwera lub dla wszystkich identyfikatorów serwera zdefiniowanych w pliku połączenia serwera:

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

  • Usuń zaszyfrowane hasło z chronionego magazynu określonego identyfikatora serwera lub dla wszystkich identyfikatorów serwera:

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

  • Wyświetl listę identyfikatorów serwera, dla których hasło jest szyfrowane:

    -p/securepassword -l/list

  • Wyeksportuj hasła przechowywane w magazynie chronionym do zaszyfrowanego pliku. Ten plik jest szyfrowany przy użyciu hasła określonego przez użytkownika.

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

  • Wcześniej wyeksportowany zaszyfrowany plik jest importowany do lokalnego magazynu chronionego przy użyciu hasła określonego przez użytkownika. Po odszyfrowaniu pliku zawartość jest przechowywana 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.

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

Przykład składni:

SSMAforAccessConsole.exe -?

Opcja pomocy SecurePassword: -securepassword -?/Pomoc

Wyświetla podsumowanie składni opcji konsoli SSMA:

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

Przykład składni:

SSMAforAccessConsole.exe -securepassword -?

Treści powiązane

  • Last updated on