処理前または処理後のスクリプトをアプリケーションに追加する方法
このトピックでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、処理前または処理後のスクリプトをアプリケーションに追加する方法について説明します。 アプリケーションに追加されたスクリプトは、アプリケーションの .msi ファイルに格納され、アプリケーションのインポート、インストール、またはアンインストール時に実行されます。
スクリプトを追加する際には、処理前のスクリプト (アプリケーションのインポートやインストールの前に実行) か処理後のスクリプト (インポートやインストール完了後に実行) かを指定する必要があります。 前処理スクリプトと後処理スクリプトはアンインストール時にも実行され、インストール時に実行された順序とは逆の順序で実行されます。前処理スクリプトはアンインストール後に実行され、後処理スクリプトはアンインストール前に実行されます。
スクリプトはアプリケーションから削除することもできます。 手順については、「 アプリケーションから前処理スクリプトまたは後処理スクリプトを削除する方法」を参照してください。
前提条件
このトピックの手順を実行するには、BizTalk Server Administrators グループのメンバーであるアカウントでログオンする必要があります。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
アプリケーションにスクリプトを追加するには
BizTalk Server 管理コンソールの使用
[スタート]、[すべてのプログラム]、[Microsoft BizTalk Server 20xx] の順にクリックし、[BizTalk Server管理] をクリックします。
BizTalk グループ、[アプリケーション] の順に展開し、スクリプトに追加するアプリケーションのフォルダーを右クリックします。
[ 追加] をポイントし、次のいずれかの操作を行います。
アプリケーション の インポートまたはインストールの開始前またはアンインストール後にスクリプトを実行する場合は、[スクリプトの前処理] をクリックします。
アプリケーションのインポートまたはインストール後、またはアンインストールの前にスクリプトを実行する場合は、[ スクリプトの後処理 ] をクリックします。
[ 追加] をクリックし、追加するスクリプト ファイルを参照します。
スクリプト ファイルを選択し、[ 開く] をクリックします。
アプリケーションに既に存在するスクリプト ファイルを上書きする場合は、[すべてのチェックを上書きする] ボックスを選択します。 上書きされるスクリプト ファイルは、追加するファイルと同じ名前である必要があります。 同じ名前のファイルがない場合は、新しいスクリプト ファイルが追加され、アプリケーションの既存のスクリプト ファイルは変更されません。
[ ファイルの種類 ] ドロップダウン リストをクリックし、ファイルの種類 ( System.BizTalk:PreprocessingScript または System.BizTalk:PostprocessingScript) をクリックします。
必要に応じて、[ 宛先の場所] に、アプリケーションのインストール時にスクリプト ファイルをコピーするパスを入力し、[OK] をクリック します。 既定のパスでは、スクリプトはアプリケーションのインストール フォルダー (%BTAD_InstallDir%) にインストールされます。
Note
このパスを指定しないと、スクリプトはインストール時にローカル ファイル システムにコピーされません。 このスクリプトをアプリケーションのアンインストール時に実行する必要がある場合は、必ずこのパスを指定してください。指定しないと、スクリプトがローカル ファイル システムに格納されないため、アンインストール中に実行できません。
スクリプト ファイルが追加されて、アプリケーションのリソース フォルダーに表示されます。
コマンド ラインの使用
コマンド プロンプトを次のように開きます。[ スタート] をクリックし、[ 実行] をクリックし、「」と入力
cmdして、[OK] をクリック します。次の表に示すように、適切な値を置き換え、次のコマンドを入力します。
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 コマンド: 処理後のスクリプト