Microsoft 提供一套強大的命令列選項,用以執行與控制 SQL Server 遷移助理(SSMA)活動。 在下列各節中深入瞭解。
SSMA 控制台中的命令行選項
本節描述主控台指令選項。
在本節中, 選項 與 開關 指的是同一事物。
選項不區分大小寫,可以從 - 或 / 字元開頭。
如果你指定選項,也必須指定相應的選項參數。
你必須用空白區分選項參數和選項字元。
語法範例:
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"
包含空格的資料夾或檔案名稱必須以雙引號標示。
命令列輸入和錯誤訊息的輸出會傳送到 stdout 或指定的檔案。
腳本檔案選項:-s/script
使用此強制切換器來指定腳本檔案路徑與名稱。 腳本檔案包含 SSMA 執行的指令序列。
語法範例:
SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml"
變數值檔案選項:-v/variable
使用此可選的開關來指定變數值檔案。 該檔案包含腳本檔案中使用的變數。 如果腳本檔案使用了變數未在變數值檔中宣告的變數,SSMA 會產生錯誤並終止主控台執行。
語法範例:
定義多個變數值檔案中的變數,例如一個預設值的檔案和一個實例特定值的檔案。 如果變數重複,命令列參數中指定的最後一個變數檔案會優先:
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"
伺服器連線檔案選項:-c/serverconnection
此檔案包含每部伺服器的伺服器連接資訊。 每個伺服器定義皆以獨特的伺服器 ID 來識別。 腳本檔會在連線相關指令中引用每個伺服器 ID。
伺服器定義可以是伺服器連線檔案或腳本檔案的一部分。 如果伺服器 ID 有重複,腳本檔案的伺服器 ID 會優先於伺服器連線檔案。
語法範例:
在腳本檔中使用伺服器 ID,並在獨立的伺服器連線檔案中定義它們。 此檔案會使用變數值檔案中定義的變數:
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將伺服器定義嵌入腳本檔案中:
SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml"
XML 輸出選項:-x/xmloutput [xmloutputfile]
使用此指令將指令輸出訊息以 XML 格式輸出,無論是傳送到主控台或 XML 檔案。
xmloutput 有兩個選擇。
在
xmloutput切換後,如果提供了檔案路徑,則將輸出重定向到該檔案。語法範例:
SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml如果您在
xmloutput參數後沒有提供檔案路徑,輸出會顯示在主控台上。語法範例:
SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput
記錄檔選項:-l/log
主控台應用程式會將所有 SSMA 操作記錄在日誌檔中。 開關是可選的。 如果你在命令列指定日誌檔案及其路徑,日誌會在指定位置產生。 否則,日誌會自動在預設位置產生。
語法範例:
SSMAforAccessConsole.exe "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l C:\SsmaProjects\migration1.log
項目環境資料夾選項:-e/projectenvironment
使用此可選的開關來指定目前 SSMA 專案的專案環境設定資料夾。
語法範例:
SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e C:\SsmaProjects\CommonEnvironment
安全密碼選項:-p/securepassword
使用此選項指定伺服器連線的加密密碼。 它與其他選項不同的是,它不會執行任何腳本,也不會協助任何遷移相關的活動。 相反地,它幫助管理遷移專案中使用的伺服器連線的密碼加密。
當你使用這個選項時,必須是你唯一提供的參數。 任何其他選項或密碼都會導致指令失敗。 欲了解更多資訊,請參閱 「管理密碼 」章節。
-p/securepassword支援下列子選項:
在受保護儲存中新增或更新指定伺服器 ID 的密碼,或伺服器連接檔案中定義的所有伺服器 ID 密碼:
-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]將加密密碼從指定的伺服器 ID 或所有伺服器 ID 的受保護儲存中移除。
-p/securepassword -r/remove {<server_id> [, ...n] | all}顯示加密密碼的伺服器 ID 清單:
-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>你可以用逗號分隔符指定多個伺服器 ID。
說明選項:-?/說明
顯示 SSMA 主控台選項的語法摘要。
關於 SSMA 主控台命令列選項的表格顯示,請參見 附錄 - 1。
語法範例:
SSMAforAccessConsole.exe -?
SecurePassword 說明選項:-securepassword -?/說明
顯示 SSMA 控制台選項的語法摘要:
關於 SSMA 主控台命令列選項的表格顯示,請參見 附錄 - 1。
語法範例:
SSMAforAccessConsole.exe -securepassword -?