共用方式為

SSMA 主控台中的命令列選項 (DB2ToSQL)

  • 發行項

Microsoft 提供一組完善的命令列選項，可執行及控制 SSMA 活動。 後幾節會詳細說明相同的內容。

SSMA 主控台中的命令列選項

此處說明的是主控台命令選項。

為配合本節的用途，「選項」一詞也會稱為「切換」。

選項不區分大小寫，而且開頭可能是 '-' 或 '/' 字元。

如果指定了選項，就必須指定對應的選項參數。

選項參數必須以空白字元分隔選項字元。

語法範例：

C:\> SSMAforDB2Console.EXE -s scriptfile

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

應以雙引號指定包含空格的資料夾或檔名。

命令列項目和錯誤訊息的輸出會儲存在 STDOUT 或指定的檔案中。

指令檔選項：-s/script

必要切換，指令檔路徑/名稱會指定要由 SSMA 執行的命令序列指令碼。

語法範例：

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

變數值檔案選項：-v/variable

此檔案包含指令檔中所使用的變數。 這是選擇性切換。 如果變數沒有在變數檔中宣告並在指令檔中使用，則應用程式會產生錯誤並終止主控台執行。

語法範例：

  • 變數可在多個變數值檔案中定義，可能具有預設值，也可能在適用情況下具有執行個體專屬值。 命令列引數中指定的最後一個變數檔會採用喜好設定，以防變數重複：

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

伺服器連接檔選項：-c/serverconnection

此檔案包含每部伺服器的伺服器連接資訊。 每個伺服器定義都是以唯一的伺服器識別碼識別。 指令檔中的連接相關命令會參考伺服器識別碼。

伺服器定義可以是伺服器連接檔和/或指令檔的一部分。 指令檔中的伺服器識別碼優先於伺服器連接檔，以防伺服器識別碼重複。

語法範例：

  • 伺服器識別碼會用於指令檔，而且其定義於不同的伺服器連接檔中，伺服器連接檔會使用變數值檔中所定義的變數：

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

  • 伺服器定義內嵌在指令檔中：

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

XML 輸出選項：-x/xmloutput [xmloutputfile]

此命令用於將命令輸出訊息以 xml 格式輸出至主控台或 xml 檔。

有兩個選項可用於 xmloutput，也就是：

  • 如果在 xmloutput 切換之後提供 filepath，系統會將輸出重新導向至檔案。

    語法範例：

    C:\>SSMAforDB2Console.EXE -s

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

  • 如果 xmloutput 切換之後沒有提供 filepath，則會直接在主控台上顯示 xmlout。

    語法範例：

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

記錄檔選項：-l/log

主控台應用程式中的所有 SSMA 作業都會記錄在記錄檔中。 這是選擇性切換。 如果在命令列指定記錄檔及其路徑，就會在指定的位置產生記錄檔。 否則，則會在其預設位置中產生。

語法範例：

C:\>SSMAforDB2Console.EXE

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

專案環境資料夾選項：-e/projectenvironment

這表示目前 SSMA 專案的專案環境設定資料夾。 此切換是選用的。

語法範例：

C:\>SSMAforDB2Console.EXE -s

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

安全密碼選項：-p/securepassword

此選項表示伺服器連接的加密密碼。 它與所有其他選項不同：該選項既不會執行任何指令碼，也不會協助進行任何與移轉相關的活動，但有助於管理移轉專案中所用伺服器連接的密碼加密。

您無法輸入任何其他選項或密碼作為命令列參數。 否則會導致錯誤發生。 如需詳細資訊，請參閱管理密碼一節。

支援 -p/securepassword 的下列子選項：

  • 將密碼新增到指定的伺服器識別碼或伺服器連接檔中定義的所有伺服器識別碼的受保護儲存體。 以下的 -overwrite 選項會在密碼已存在時更新密碼：

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

  • 從指定伺服器識別碼或所有伺服器識別碼的受保護儲存體中移除加密的密碼：

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

  • 顯示密碼經過加密的伺服器識別碼清單：

    -p/securepassword -l/list

  • 將儲存在受保護儲存體中的密碼匯出至加密檔案。 此檔案會透過使用者指定的複雜密碼進行加密。

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

  • 先前匯出的加密檔案會透過使用者指定的複雜密碼匯入至本機受保護的儲存體。 檔案解密之後，會儲存在本機電腦上的新加密檔案中。

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

    您可使用逗號分隔符號來指定多個伺服器識別碼。

說明選項：-?/Help

顯示 SSMA 主控台選項的語法摘要：

C:\>SSMAforDB2Console.EXE -?

如需 SSMA 主控台命令列選項的表格式顯示，請參閱附錄 - 1 (DB2ToSQL)。

SecurePassword 說明選項：-securepassword -?/Help

顯示 SSMA 主控台選項的語法摘要：

C:\>SSMAforDB2Console.EXE -securepassword -?

如需 SSMA 主控台命令列選項的表格式顯示，請參閱附錄 - 1 (DB2ToSQL)

後續步驟

下一個步驟取決於您的專案需求：

  1. 如需指定密碼或匯出/匯入密碼，請參閱管理密碼 (DB2ToSQL)。

  2. 如需產生報告，請參閱產生報告 (DB2ToSQL)。

  3. 如需針對主控台中的問題進行疑難排解，請參閱疑難排解 (DB2ToSQL)。