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 によって識別されます。 サーバーの ID は、接続関連のコマンドのスクリプト ファイルで参照されます。

サーバー定義は、サーバー接続ファイルまたはスクリプト ファイルの一部である場合があります。 サーバー ID が重複している場合は、スクリプト ファイルのサーバー ID がサーバー接続ファイルよりも優先されます。

構文の例:

  • サーバーの 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 には、次の 2 つのオプションがあります。

  • xmloutput スイッチの後にファイルパスが指定されている場合、出力はファイルにリダイレクトされます。

    構文の例:

    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 スイッチの後にファイルパスが指定されない場合、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

Project環境フォルダー オプション: -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

  • 指定したサーバー 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}

  • パスワードが暗号化されているサーバーの一覧を表示するには:

    -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 を指定できます。

ヘルプ オプション: -?/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 のトラブルシューティング(を参照)。