SSMA コンソールのコマンドラインオプション (Db2ToSQL)

[アーティクル]
10/22/2024

SQL Server Migration Assistant (SSMA) には、Db2 アクティビティを実行および制御するための堅牢な一連のコマンドラインオプションが用意されています。次のセクションの詳細は同じです。

SSMA コンソールのコマンドラインオプション

このセクションでは、コンソールコマンドオプション (スイッチとも呼ばれます) について説明します。

オプションでは大文字と小文字が区別されず、文字または文字で-/始まる場合があります。

オプションを指定する場合は、対応するオプションパラメーターを指定する必要があります。

オプションパラメーターは、オプション文字から空白で区切る必要があります。

構文の例:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ServersConnectionFileSample.xml"

スペースを含むフォルダーとファイル名は、二重引用符で囲んで指定する必要があります。

コマンドラインエントリとエラーメッセージの出力は、STDOUT または指定されたファイルに格納されます。

スクリプトファイルオプション: -s |スクリプト

必須スイッチであるスクリプトファイルのパス/名前は、SSMA が実行するコマンドシーケンスのスクリプトを指定します。

構文の例:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

変数値ファイルオプション: -v |変数

このファイルは、スクリプトファイルで使用される変数で構成されます。このスイッチはオプションです。変数が変数ファイルで宣言されておらず、スクリプトファイルで使用されている場合、アプリケーションはエラーを生成し、コンソールの実行を終了します。

構文の例:

複数の変数値ファイルで定義されている変数(既定値を持つ変数と、該当する場合はインスタンス固有の値を持つ変数)。変数が重複している場合は、コマンドライン引数で指定された最後の変数ファイルが優先されます。

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\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 はスクリプトファイルで使用され、別のサーバー接続ファイルで定義します。サーバー接続ファイルは変数を使用します。変数は変数値ファイルで定義されています。
```
SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\SsmaProjects\myvaluefile1.xml -c C:\SsmaProjects\myserverconnectionsfile1.xml
```

サーバー定義はスクリプトファイルに埋め込まれています。

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

XML 出力オプション: -x |xmloutput [ xmloutputfile ]

このコマンドは、コンソールまたは XML ファイルに XML 形式でコマンド出力メッセージを出力するために使用されます。

次の 2 つのオプションを xmloutput使用できます。

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

構文の例:

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

スイッチの後に xmloutput ファイルパスが指定されていない場合は、 xmlout コンソール自体に表示されます。

構文の例:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

ログファイルオプション: -l |丸太

コンソールアプリケーションのすべての SSMA 操作がログファイルに記録されます。このスイッチはオプションです。コマンドラインでログファイルとそのパスを指定すると、指定した場所にログが生成されます。それ以外の場合は、既定の場所で生成されます。

構文の例:

SSMAforDb2Console.exe "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l C:\SsmaProjects\migration1.log

プロジェクト環境フォルダーオプション: -e |projectenvironment

現在の SSMA プロジェクトのプロジェクト環境設定フォルダーを示します。このスイッチはオプションです。

構文の例:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e C:\SsmaProjects\CommonEnvironment

セキュリティで保護されたパスワードオプション: -p |securepassword

このオプションは、サーバー接続の暗号化されたパスワードを示します。他のすべてのオプションとは異なります。このオプションではスクリプトが実行されないか、移行関連のアクティビティで役立ちます。代わりに、移行プロジェクトで使用されるサーバー接続のパスワード暗号化を管理するのに役立ちます。

コマンドラインパラメーターとして他のオプションやパスワードを入力することはできません。それ以外の場合、エラーが発生します。詳細については、「パスワードの管理」を参照してください。

-p | securepassword に対して、次のサブオプションがサポートされています。

指定されたサーバー ID またはサーバー接続ファイルで定義されているすべてのサーバー ID の保護されたストレージにパスワードを追加します。このオプションは -overwrite 、パスワードが既に存在する場合に更新します。

-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 コンソールオプションの構文の概要を表示します。

SSMAforDb2Console.exe -?

SSMA コンソールのコマンドラインオプションの表形式の表示については、「付録 1: コンソールコマンドラインオプション」を参照してください。

SecurePassword ヘルプオプション: -securepassword -? |ヘルプ

SSMA コンソールオプションの構文の概要を表示します。

SSMAforDb2Console.exe -securepassword -?

SSMA コンソールのコマンドラインオプションの表形式の表示については、「付録 1: コンソールのコマンドラインオプション」を参照してください。

次の方法で共有

SSMA コンソールのコマンドラインオプション (Db2ToSQL)