BizTalk アセンブリをアプリケーションに追加する方法
ここでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、BizTalk アセンブリをアプリケーションに追加する方法について説明します。
BizTalk アセンブリをアプリケーションに追加する際には、次の重要事項を念頭に置いてください。
アセンブリを追加して、アプリケーション内に既に存在する同じローカル一意識別子 (LUID) でアセンブリを上書きする場合は、[上書き] オプションを指定します。 指定しないと、追加するアセンブリと同じ LUID のアセンブリがアプリケーション内に既に存在する場合、操作は失敗します。 LUID には、アセンブリ ファイル名、バージョン、カルチャ、および公開キー トークンが含まれます。 ListApp コマンドを使用して、アプリケーション内の成果物の LUID を表示できます。
また、追加するアセンブリが、そのアプリケーションには含まれない他のアイテムに依存している場合、追加操作は失敗します。
BizTalk アセンブリを追加する場合、アセンブリをグローバル アセンブリ キャッシュ (GAC) にインストールするための次のオプションを 1 つ以上指定できます。
[追加リソースのグローバル アセンブリ キャッシュに追加します (gacutil)] : このオプションを選択すると、アセンブリがアプリケーションに追加されるときに、このトピックで説明する手順を実行した結果として、アセンブリはローカル コンピューターの GAC にインストールされます。
[MSI ファイル インポートのグローバル アセンブリ キャッシュに追加します (gacutil)] : このオプションを選択すると、アプリケーションが .msi ファイルにエクスポートされ、.msi ファイルが BizTalk グループにインポートされた場合、アセンブリはインポート処理の一部として、ローカル コンピューターの GAC にインストールされます。
[MSI ファイル インストールのグローバル アセンブリ キャッシュに追加します (gacutil)] : このオプションを選択すると、アプリケーションが .msi ファイルにエクスポートされ、アプリケーションが .msi ファイルからコンピューターにインストールされた場合、アセンブリはインポート処理の一部として、ローカル コンピューターの GAC にインストールされます。
前提条件
このトピックの手順を実行するには、BizTalk Server Administrators グループのメンバーであるアカウントでログオンする必要があります。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
BizTalk アセンブリをアプリケーションに追加するには
BizTalk Server 管理コンソールの使用
[スタート]、[すべてのプログラム]、[Microsoft BizTalk Server 20xx] の順にクリックし、[BizTalk Server管理] をクリックします。
コンソール ツリーで、[BizTalk Server管理] と、BizTalk アセンブリを追加するアプリケーションを含む BizTalk グループを展開します。
[アプリケーション]、BizTalk アセンブリを追加するアプリケーションの順に展開します。
[ リソース] を右クリックし、[ 追加] をポイントして、[ BizTalk アセンブリ] をクリックします。
[ 追加] をクリックし、BizTalk アセンブリ ファイルを選択して、[ 開く] をクリックします。
[ 宛先] に、アプリケーションが .msi ファイルからインストールされるときにアセンブリ ファイルをコピーする場所の完全パスを入力します (ファイル名を含む)。 指定しなかった場合、インストール中、アセンブリ ファイルはローカル ファイル システムにコピーされません。
[ オプション] で、BizTalk アセンブリを GAC にインストールするためのオプションを指定し、[OK] をクリック します。
コマンド ラインの使用
コマンド プロンプトを次のように開きます。[ スタート] をクリックし、[ 実行] をクリックし、「」と入力
cmdして、[OK] をクリック します。次の表に示すように、適切な値を置き換え、次のコマンドを入力します。
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/Server:value] [/Database:value]
例:
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite /Source:"C:\BizTalk Assemblies\MyOrchestration.dll" /Destination:"C:\New BizTalk Assemblies\ MyOrchestration.dll " /Server:MyDatabaseServer /Database:BizTalkMgmtDb
パラメーター 値 /Applicationname BizTalk アセンブリを追加する BizTalk アプリケーションの名前。 アプリケーション名が指定されなかった場合、既定の BizTalk アプリケーションが使用されます。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 /型 System.BizTalk:BizTalkAssembly /上書き 既存のアセンブリを更新するためのオプション。 指定しないと、追加するアセンブリと同じ LUID のアセンブリが既にアプリケーションに存在した場合、AddResource 操作は失敗します。 ListApp コマンドを使用して、アプリケーション内の成果物の LUID を表示できます。 他のアプリケーションが、上書きされようとしているアセンブリに依存している場合、このパラメーターを指定したとしても AddResource 操作は失敗します。 /ソース アセンブリ ファイルの完全パス (ファイル名を含む)。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 /先 アプリケーションを .msi ファイルからインストールしたときにアセンブリ ファイルがコピーされる場所 (完全パス)。 指定しなかった場合、インストール中、アセンブリ ファイルはローカル ファイル システムにコピーされません。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 /オプション - GacOnAdd: AddResource 操作中に、ローカル コンピューター上のグローバル アセンブリ キャッシュ (GAC) にアセンブリをインストールするように指定します。
- GacOnInstall: アプリケーションが .msi ファイルからインストールされるときに、アセンブリを GAC にインストールするように指定します。
- GacOnImport: アプリケーション .msi ファイルがインポートされるときにアセンブリを GAC にインストールするように指定します。
複数のオプションを入力する場合は、コンマで区切って入力します。/サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。
インスタンス名の指定は、そのインスタンス名がサーバー名と異なる場合にのみ必要です。 ポートの指定は、SQL Server で使用するポート番号が既定値 (1433) と異なる場合にのみ必要です。
例 :
Server=MyServer
Server=MyServer\MySQLServer,1533
指定しなかった場合、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。/データベース BizTalk 管理データベースの名前。 指定しなかった場合、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。