共用方式為

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

  • 發行項

Microsoft提供一組健全的命令行選項，以執行及控制 SSMA 活動。 隨後的各節會提供其他詳細數據。

SSMA 控制台中的命令行選項

此處所述的是主控台命令選項。

本節中，‘option’ 一詞也稱為 ‘switch’。

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

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

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

語法範例：

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"

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

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

腳本檔案選項：-s/script

必填項，腳本檔案路徑/名稱會指定要由 SSMA 執行的命令序列。

語法範例：

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

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

變數值檔案包含腳本檔案中使用的變數。 開關是可選的。 如果未在變數檔案中宣告變數，並在腳本檔案中使用變數，應用程式會產生錯誤並終止主控台執行。

語法範例：

  • 在多個變數值檔案中定義的變數，可能是一個具有預設值，另一個變數在適用時具有實例特定值。 命令列參數中指定的最後一個變數檔案將優先考慮，如果出現變數重複情況。

    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"

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

此檔案包含每部伺服器的伺服器連接資訊。 每個伺服器定義都是由唯一的伺服器標識碼來識別。 伺服器 ID 會被腳本檔案中的連線相關命令所引用。

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

語法範例：

  • 伺服器識別碼用於腳本檔案中。 它們定義於個別的伺服器連接檔案中。 此檔案會使用變數值檔案中定義的變數：

    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

  • 伺服器定義內嵌在文稿檔案中：

    C:\>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 參數之後提供 filepath，則會將輸出重新導向至檔案。

    語法範例：

    C:\>SSMAforAccessConsole.EXE -s

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

  • 如果在 xmloutput 切換之後未提供任何 filepath，則會在控制台上顯示 XML 輸出。

    語法範例：

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

記錄檔選項：-l/log

主控台應用程式中的所有 SSMA 作業都會記錄在記錄檔中，而且開關是選擇性的。 如果在命令行指定記錄檔及其路徑，則會在指定的位置產生記錄檔。 否則，它會在其預設位置生成。

語法範例：

C:\>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 專案的專案環境設定資料夾。

語法範例：

C:\>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支援下列子選項：

  • 若要為指定的伺服器識別碼或伺服器連接檔中定義的所有伺服器識別碼，新增密碼或更新現有密碼至受保護的儲存位置：

    -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 控制台選項的語法摘要：

C:\>SSMAforAccessConsole.EXE -?

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

SecurePassword 說明選項：-securepassword -？/說明

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

C:\>SSMAforAccessConsole.EXE -securepassword -?

如需 SSMA 控制台命令行選項的表格式顯示，請參閱 附錄 - 1 （AccessToSQL）

後續步驟

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

  1. 如需指定密碼或匯出/匯入密碼，請參閱 管理密碼 （AccessToSQL）。

  2. 如需產生報表，請參閱 產生報表 （AccessToSQL）。

  3. 如需針對控制台中的問題進行疑難解答，請參閱 疑難解答 （AccessToSQL）。