共用方式為


SSMA 控制台中的命令列選項 (AccessToSQL)

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