このトピックでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、BIZTalk アプリケーションに BAM 成果物を追加する方法について説明します。 BAM 定義ファイルを追加しても、BAM 定義は展開されません。 BAM 定義は、アプリケーション .msi ファイルがインポートされるときに展開されます。
アプリケーションに既に存在する BAM アーティファクトを上書きする場合は、上書きオプションを指定します。 上書きオプションは、既存の BAM アーティファクトが追加するファイル名と同じ場合にのみ必要です。 指定されていない場合、追加するファイル名と同じファイル名を持つ BAM アーティファクトがアプリケーションに既に存在する場合、追加操作は失敗します。
[前提条件]
このトピックの手順を実行するには、BizTalk Server Administrators グループのメンバーであるアカウントでログオンする必要があります。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
BAM 成果物をアプリケーションに追加するには
BizTalk Server 管理コンソールの使用
[ スタート] をクリックし、[ Al Programs]、[ Microsoft BizTalk Server 20xx] の順にクリックし、[ BizTalk Server Administration]\(BizTalk Server 管理\) をクリックします。
コンソール ツリーで、BizTalk Server 管理を展開し、BizTalk グループを展開し、アプリケーションを展開し、BAM アーティファクト ファイルを追加するアプリケーションを展開します。
[リソース] フォルダーを右クリックし、[追加] をポイントして、[リソース] をクリックします。
[ 追加] をクリックし、BAM アーティファクトのファイルを選択して、[ 開く] をクリックします。
[ ファイルの種類 ] ドロップダウン リストで、[ System.BizTalk:BAM] を選択します。
[宛先] に、.msi ファイルからアプリケーションをインストールするときに成果物ファイルをコピーする場所の完全なパス (ファイル名を含む) を入力します。 このパスが指定されていない場合、インストール時にファイルはローカル ファイル システムにコピーされませんが、アプリケーション .msi ファイルがインポートされるときに展開されます。
例: C:\My Applications\MyBAMfile.xml
完了したら、 [OK] をクリックします。
コマンド ラインの使用
コマンド プロンプトを開きます。[ スタート] をクリックし、[ 実行] をクリックし、「
cmd
」と入力して、[ OK] をクリックします。次の表に示すように、適切な値に置き換えて、次のコマンドを入力します。
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Bam [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value]
例:
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Bam /Overwrite /Source:"C:\Source BAMfiles\MyBAMfile.xml" /Destination:"%BTADInstallDir%\ BAMfiles\MyBAMfile.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
パラメーター 価値 /ApplicationName BAM 成果物を追加する BizTalk アプリケーションの名前。 アプリケーション名が指定されていない場合は、グループの既定の BizTalk アプリケーションが使用されます。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 /種類 System.BizTalk:Bam (この値は大文字と小文字を区別しません)。 /上書き 既存の BAM アーティファクトを上書きするオプション。 指定されていない場合、追加する BAM 成果物と同じファイル名を持つ BAM アーティファクトが既にアプリケーションに存在する場合、AddResource 操作は失敗します。 /源 BAM アーティファクト ファイルの完全なパス (ファイル名を含む)。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 /行き先 .msi ファイルからアプリケーションをインストールするときに BAM アーティファクト ファイルをコピーする場所の完全パス。 指定しない場合、インストール時にファイルはローカル ファイル システムにコピーされません。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 パスに %BTADInstallDir% 環境変数を使用して、アプリケーションのインストール フォルダーを指定できます。 /サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前 。ServerName\InstanceName,Port という形式です。
インスタンス名は、インスタンス名がサーバー名と異なる場合にのみ必要です。 ポートは、SQL Server が既定 (1433) 以外のポート番号を使用する場合にのみ必要です。
例:
Server=MyServer
Server=MyServer\MySQLServer,1533
指定しない場合は、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。/データベース BizTalk 管理データベースの名前。 指定しない場合は、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。
こちらもご覧ください
.NET アセンブリ、証明書、およびその他のリソースの管理
AddResource コマンド: BAM アーティファクト
BizTalk アプリケーションの作成と変更
BizTalk アプリケーションをインポートする方法