このトピックでは、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 アセンブリを追加するアプリケーションを含む BizTalk Server 管理と 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 管理データベースが使用されます。