分享方式：

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

  • 文章

Microsoft 提供一組完善的命令列選項，可執行及控制 SSMA 活動。 以下各節將提供其他詳細資料。

SSMA 主控台中的命令列選項

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

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

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

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

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

語法範例：

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

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

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

語法範例：

  • 伺服器識別碼用於指令檔中。 這類識別碼會在不同的伺服器連線檔中定義。 此檔案會使用變數值檔案中定義的變數：

    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，則會直接在主控台上顯示 xmlout。

    語法範例：

    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>

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

說明選項：-?/Help

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

C:\>SSMAforAccessConsole.EXE -?

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

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

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

C:\>SSMAforAccessConsole.EXE -securepassword -?

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

下一步

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

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

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

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