Bagikan melalui

Opsi baris perintah di Konsol SSMA (AccessToSQL)

  • Artikel

Microsoft memberi Anda serangkaian opsi baris perintah yang kuat untuk menjalankan dan mengontrol aktivitas SSMA. Bagian berikutnya memberikan detail tambahan.

Opsi baris perintah di Konsol SSMA

Dijelaskan di sini adalah opsi perintah konsol.

Untuk tujuan bagian ini, istilah 'opsi' juga disebut sebagai 'switch'.

Opsi tidak peka huruf besar/kecil dan dapat dimulai dengan karakter '-' atau ''/.

Jika opsi ditentukan, Anda harus menentukan parameter opsi yang sesuai.

Parameter opsi harus dipisahkan dari karakter opsi dengan spasi kosong.

Contoh sintaks:

C:\> SSMAforAccessConsole.EXE -s scriptfile

C:\> 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"

Nama folder atau file yang berisi spasi harus ditentukan dalam tanda kutip ganda.

Output entri baris perintah dan pesan kesalahan disimpan di STDOUT atau dalam file tertentu.

Opsi file skrip: -s/script

Sakelar wajib, jalur/nama file skrip menentukan skrip urutan perintah yang akan dijalankan oleh SSMA.

Contoh sintaks:

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

Opsi file nilai variabel: -v/variable

File nilai variabel terdiri dari variabel yang digunakan dalam file skrip. Sakelar bersifat opsional. Jika variabel tidak dideklarasikan dalam file variabel dan digunakan dalam file skrip, aplikasi menghasilkan kesalahan dan mengakhiri eksekusi konsol.

Contoh sintaks:

  • Variabel yang ditentukan dalam beberapa file nilai variabel, mungkin satu dengan nilai default dan yang lain dengan nilai khusus instans jika berlaku. File variabel terakhir yang ditentukan dalam argumen baris perintah mengambil preferensi, jika ada duplikasi variabel:

    C:\>SSMAforAccessConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v c:\migration

    projects\global_variablevaluefile.xml -v "c:\migrationprojects\instance_variablevaluefile.xml"

Opsi file koneksi server: -c/serverconnection

File ini berisi informasi koneksi server untuk setiap server. Setiap definisi server diidentifikasi oleh ID Server yang unik. ID Server dirujuk dalam file skrip untuk perintah terkait koneksi.

Definisi server dapat menjadi bagian dari file koneksi server dan/atau file skrip. Id server dalam file skrip lebih diutamakan daripada file koneksi server, jika ada duplikasi id server.

Contoh sintaks:

  • ID server digunakan dalam file skrip. Mereka didefinisikan dalam file koneksi server terpisah. File ini menggunakan variabel yang ditentukan dalam file nilai variabel:

    C:\>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

  • Definisi server disematkan dalam file skrip:

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

Opsi output XML: -x/xmloutput [xmloutputfile]

Perintah ini digunakan untuk menghasilkan pesan output perintah dalam format xml baik ke konsol atau ke file xml.

Ada dua opsi yang tersedia untuk xmloutput, yaitu:

  • Jika jalur file disediakan setelah sakelar xmloutput, output dialihkan ke file.

    Contoh sintaks:

    C:\>SSMAforAccessConsole.EXE -s

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

  • Jika tidak ada jalur file yang disediakan setelah sakelar xmloutput, xmlout ditampilkan di konsol itu sendiri.

    Contoh sintaks:

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

Opsi file log: -l/log

Semua operasi SSMA di aplikasi Konsol direkam dalam file log, dan sakelar bersifat opsional. Jika file log dan jalurnya ditentukan di baris perintah, log akan dihasilkan di lokasi yang ditentukan. Jika tidak, itu akan dihasilkan di lokasi defaultnya.

Contoh sintaks:

C:\>SSMAforAccessConsole.EXE

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

Opsi folder lingkungan proyek: -e/projectenvironment

Sakelar opsional ini menunjukkan folder pengaturan lingkungan proyek untuk proyek SSMA saat ini.

Contoh sintaks:

C:\>SSMAforAccessConsole.EXE -s

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

Opsi kata sandi aman: -p/securepassword

Opsi ini menunjukkan kata sandi terenkripsi untuk koneksi server. Ini berbeda dari semua opsi lain karena tidak menjalankan skrip atau bantuan apa pun dalam aktivitas terkait migrasi apa pun, tetapi membantu mengelola enkripsi kata sandi untuk koneksi server yang digunakan dalam proyek migrasi.

Anda tidak dapat memasukkan opsi atau kata sandi lain sebagai parameter baris perintah. Jika tidak, itu menghasilkan kesalahan. Untuk informasi selengkapnya, lihat bagian Mengelola Kata Sandi .

Subopsi berikut didukung untuk -p/securepassword:

  • Untuk menambahkan kata sandi, atau memperbarui kata sandi yang ada, ke penyimpanan yang dilindungi untuk ID Server tertentu atau untuk semua ID Server yang ditentukan dalam file koneksi server:

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

  • Untuk menghapus kata sandi terenkripsi dari penyimpanan terproteksi ID Server yang ditentukan atau untuk semua ID Server:

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

  • Untuk menampilkan daftar ID Server yang kata sandinya dienkripsi:

    -p/securepassword -l/list

  • Untuk mengekspor kata sandi yang disimpan dalam penyimpanan yang dilindungi ke file terenkripsi. File ini dienkripsi dengan frasa sandi yang ditentukan pengguna.

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

  • File terenkripsi yang sebelumnya diekspor diimpor ke penyimpanan yang dilindungi lokal menggunakan frasa sandi yang ditentukan pengguna. Setelah file didekripsi, file disimpan dalam file baru, yang pada gilirannya, dienkripsi pada komputer lokal.

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

    Beberapa ID Server dapat ditentukan menggunakan pemisah koma.

Opsi bantuan: -?/Help

Menampilkan ringkasan sintaks opsi Konsol SSMA:

C:\>SSMAforAccessConsole.EXE -?

Untuk tampilan tabular opsi baris perintah Konsol SSMA, lihat Lampiran - 1 (AccessToSQL).

Opsi Bantuan SecurePassword: -securepassword -?/Help

Menampilkan ringkasan sintaks opsi Konsol SSMA:

C:\>SSMAforAccessConsole.EXE -securepassword -?

Untuk tampilan tabular opsi baris perintah Konsol SSMA, lihat Lampiran - 1 (AccessToSQL)

Langkah berikutnya

Langkah selanjutnya tergantung pada persyaratan proyek Anda:

  1. Untuk menentukan kata sandi atau mengekspor/mengimpor kata sandi, lihat Mengelola Kata Sandi (AccessToSQL).

  2. Untuk membuat laporan, lihat Membuat Laporan (AccessToSQL).

  3. Untuk pemecahan masalah di konsol, lihat Pemecahan Masalah (AccessToSQL).