共用方式為

SSMA 控制台中的命令列選項 （Db2ToSQL）

  • 發行項

SQL Server 移轉小幫手 （SSMA） 提供一組健全的命令行選項，以執行和控制 Db2 活動。 後幾節會詳細說明相同的內容。

SSMA 控制台中的命令行選項

本節描述主控台命令選項，也稱為參數。

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

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

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

語法範例：

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 |腳本

腳本檔案路徑/名稱是強制參數，會指定 SSMA 執行之命令順序的腳本。

語法範例：

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

變數值檔案選項：-v |變數

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

語法範例：

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

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

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

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

語法範例：

  • 伺服器識別碼會用於文稿檔案中，而您會在個別的伺服器連接檔案中定義它們。 伺服器連接檔案會使用變數，這些變數定義於變數值檔中：

    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

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

    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 提供檔案路徑，輸出會重新導向至檔案。

    語法範例：

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

  • 如果在切換之後 xmloutput 未提供任何檔案路徑，則會 xmlout 在主控台本身上顯示 。

    語法範例：

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

記錄檔選項：-l |日誌

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

語法範例：

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 專案的項目環境設定資料夾。 此切換是選用的。

語法範例：

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>

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

說明選項：-？ |幫助

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

SSMAforDb2Console.exe -?

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

SecurePassword 說明選項：-securepassword -？ |幫助

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

SSMAforDb2Console.exe -securepassword -?

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

相關內容