アプリケーションに前処理スクリプトまたは後処理スクリプトを追加する方法

このトピックでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、前処理または後処理スクリプトをアプリケーションに追加する方法について説明します。 スクリプトをアプリケーションに追加すると、スクリプトはアプリケーション .msi ファイルに含まれており、アプリケーションのインポート、インストール、またはアンインストール時に実行されます。

スクリプトを追加するときは、事前前処理スクリプト (アプリケーションのインポートまたはインストールが開始される前に実行される) か、アプリケーションのインポートまたはインストールが完了した後に実行される後処理スクリプトかを指定する必要があります。 事前処理スクリプトと後処理スクリプトは、アンインストール時に実行されるのとは逆の順序で実行されます。前処理スクリプトはアンインストール後に実行され、後処理スクリプトはアンインストール前に実行されます。

アプリケーションからスクリプトを削除することもできます。 手順については、「 アプリケーションから前処理スクリプトまたは後処理スクリプトを削除する方法」を参照してください。

[前提条件]

このトピックの手順を実行するには、BizTalk Server Administrators グループのメンバーであるアカウントでログオンする必要があります。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。

アプリケーションにスクリプトを追加するには

BizTalk Server 管理コンソールの使用

1. [ スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft BizTalk Server 20xx] をクリックして、[ BizTalk Server 管理] をクリックします。

2. BizTalk グループを展開し、[アプリケーション] を展開し、スクリプトを追加するアプリケーションのフォルダーを右クリックします。

3. [ 追加] をポイントし、次のいずれかの操作を行います。

   • アプリケーション の インポートまたはインストールの開始前またはアンインストール後にスクリプトを実行する場合は、[スクリプトの前処理] をクリックします。

   • アプリケーションのインポートまたはインストール後、またはアンインストールの前にスクリプトを実行する場合は、[ スクリプトの後処理 ] をクリックします。

4. [ 追加] をクリックし、追加するスクリプト ファイルを参照します。

5. スクリプト ファイルを選択し、[ 開く] をクリックします。

6. アプリケーションに既に存在するスクリプト ファイルを上書きする場合は、[ すべて上書き ] チェック ボックスをオンにします。 スクリプト ファイルは、上書きする追加ファイルと同じファイル名にする必要があります。 それ以外の場合は、新しいスクリプトが追加され、既存のスクリプトは変更されずにアプリケーションに残ります。

7. [ ファイルの種類 ] ドロップダウン リストをクリックし、ファイルの種類 ( System.BizTalk:PreprocessingScript または System.BizTalk:PostprocessingScript) をクリックします。

8. 必要に応じて、[ 宛先の場所] に、アプリケーションのインストール時にスクリプト ファイルをコピーするパスを入力し、[OK] をクリック します。 既定のパスは、スクリプトをアプリケーションのインストール フォルダー (%BTAD_InstallDir%) にインストールします。

スクリプトがアプリケーションに追加され、アプリケーションの Resources フォルダーに表示されます。

コマンド ラインの使用

1. コマンド プロンプトを開きます。[ スタート] をクリックし、[ 実行] をクリックし、「 cmd」と入力して、[ OK] をクリックします。

2. 次の表に示すように、適切な値に置き換えて、次のコマンドを入力します。

   BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:PreProcessingScript|System.BizTalk:PostProcessingScript [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value][/Property:Args="argument list"]

   例：

   BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:PreProcessingScript /Overwrite /Source:"C:\Source Scripts\MyScript.vbs" /Destination:"C:\New Scripts\MyScript.vbs" /Server:MyDatabaseServer /Database:BizTalkMgmtDb /Property:Args="argument1 argument2"

   パラメーター	価値
   /ApplicationName	スクリプトを追加する BizTalk アプリケーションの名前。 アプリケーション名が指定されていない場合は、既定の BizTalk アプリケーションが使用されます。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
   /種類	追加するスクリプトの種類に応じて、System.BizTalk:PreProcessingScript または System.BizTalk:PostProcessingScript。 アプリケーションのインポートまたはインストールの前、またはアンインストール後にスクリプトを実行する場合は、 System.BizTalk:PreProcessingScript を使用します。 アプリケーションのインポートまたはインストール後、またはアンインストールの前にスクリプトを実行する場合は、 System.BizTalk:PostProcessingScript を使用します。
   /上書き	既存のスクリプトを更新します。 指定しない場合、追加するスクリプト ファイルと同じ名前のスクリプト ファイルがアプリケーションに既に存在する場合、追加操作は失敗します。
   /源	スクリプト ファイルの完全なパス (ファイル名を含む)。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
   /行き先	MSI ファイルからアプリケーションをインストールするときにスクリプト ファイルをコピーする場所の完全パス。 指定しない場合、インストール時にファイルはローカル ファイル システムにコピーされません。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
   /サーバー	BizTalk 管理データベースをホストする SQL Server インスタンスの名前 。ServerName\InstanceName,Port という形式です。 インスタンス名は、インスタンス名がサーバー名と異なる場合にのみ必要です。 ポートは、SQL Server が既定 (1433) 以外のポート番号を使用する場合にのみ必要です。 例： Server=MyServer Server=MyServer\MySQLServer,1533 指定しない場合は、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。
   /データベース	BizTalk 管理データベースの名前。 指定しない場合は、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。
   /Property:Args=	引数は0個以上。 ここで指定した引数は、呼び出されたときにスクリプトに渡されます。

こちらもご覧ください

前処理スクリプトと後処理スクリプトの管理
AddResource コマンド: スクリプトの前処理
AddResource コマンド: 事後処理スクリプト