次の方法で共有

.NET アセンブリをアプリケーションに追加する方法

  • [アーティクル]

このトピックでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、BizTalk アセンブリではない .NET アセンブリを BizTalk アプリケーションに追加する方法について説明します。 .NET アセンブリをアプリケーションに追加する際には、次の重要事項を念頭に置いてください。

  • アプリケーションに既に存在するアセンブリを上書きする場合は、[上書き] オプションを指定します。 [上書き] オプションは、両方のアセンブリが同じ LUID を持つ場合にのみ必要です。 このオプションを指定せず、追加するアセンブリと同じ LUID を持つアセンブリがアプリケーション内に既に存在する場合、追加操作は失敗します。 ListApp コマンドを使用して、アプリケーション内の成果物の LUID を表示できます。

  • .NET アセンブリを追加するときに、アセンブリをグローバル アセンブリ キャッシュ (GAC) にインストールするための次のオプションを 1 つ以上指定できます。

    • [追加リソースのグローバル アセンブリ キャッシュに追加します (gacutil)] : このオプションを選択すると、アセンブリがアプリケーションに追加されるときに、このトピックで説明する手順を実行した結果として、アセンブリはローカル コンピューターの GAC にインストールされます。

    • [MSI ファイル インポートのグローバル アセンブリ キャッシュに追加します (gacutil)] : このオプションを選択すると、アプリケーションが .msi ファイルにエクスポートされ、.msi ファイルが BizTalk グループにインポートされた場合、アセンブリはインポート処理の一部として、ローカル コンピューターの GAC にインストールされます。 ポリシーおよびポリシーが依存するアセンブリがアプリケーションに含まれている場合は、このオプションをオンにします。 ポリシーが含まれているアプリケーションをインポートする場合、そのポリシーが依存するアセンブリが GAC に存在している必要があります。したがって、このオプションをオンにする必要があります。

    • [MSI ファイル インストールのグローバル アセンブリ キャッシュに追加します (gacutil)] : このオプションを選択すると、アプリケーションが .msi ファイルにエクスポートされ、アプリケーションが .msi ファイルからコンピューターにインストールされた場合、アセンブリはインポート処理の一部として、ローカル コンピューターの GAC にインストールされます。

    • [COM コンポーネントから参照できるようにします (regasm)]。 このオプションをオンにすると、アプリケーションを .msi ファイルにエクスポートし、その .msi ファイルからアプリケーションをコンピューターにインストールした場合、マネージド COM アセンブリが、インストール処理の一部として、ローカル コンピューターの Windows レジストリに追加されます。 このオプションを指定する場合は、[エクスポート先] でファイルの場所も指定する必要があります。

    • [提供されたコンポーネントを登録します (regsvcs)]。 このオプションをオンにすると、アプリケーションを .msi ファイルにエクスポートし、その .msi ファイルからアプリケーションをコンピューターにインストールした場合、マネージド COM+ アセンブリが、インストール処理の一部として、ローカル コンピューターの Windows レジストリに追加されます。 このオプションを指定する場合は、[エクスポート先] でファイルの場所も指定する必要があります。

前提条件

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

.NET アセンブリをアプリケーションに追加するには

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

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

  2. コンソール ツリーで、[BizTalk Server管理] を展開し、[BizTalk] グループを展開し、[アプリケーション] を展開して、.NET アセンブリを追加するアプリケーションを展開します。

  3. [リソース] フォルダーを右クリックし、[追加] をポイントして、[リソース] をクリックします。

  4. [ 追加] をクリックし、アセンブリをクリックして、[ 開く] をクリックします。

  5. [ ファイルの種類 ] ドロップダウン リストで、[ System.BizTalk:Assembly] を選択します。

  6. [オプション] で、このアセンブリの配置オプションを選択します。

  7. [ 宛先] に、アプリケーションが .msi ファイルからインストールされるときにファイルをコピーする場所の完全なパス (ファイル名を含む) を入力します。 このパスを指定しないと、インストールでローカル ファイル システムにファイルがコピーされません。 アプリケーションのインストール フォルダーにファイルをコピーする場合、%BTAD_InstallDir% 環境変数をパスで使用できます。この環境変数は、アプリケーションのインストール フォルダーの値を、アプリケーションのインストール時に受け取ります。 このように、コピー先を指定する際には、アプリケーションのインストール フォルダーのパスを知る必要はありません。

    例: %BTADInstall_Dir%\Assemblies\Orchestrations.dll

  8. [ 依存関係 ] タブをクリックし、このアセンブリが依存する成果物を表示します。

  9. このアセンブリが依存する成果物がこのアプリケーションに存在せず、それを追加する場合は、[ アプリケーションに追加] をクリックし、成果物を参照して [ 開く] をクリックします。

  10. 完了したら、 [OK] をクリックします。

コマンド ラインの使用

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

  2. コマンド プロンプトで次のコマンドを入力します。このとき、下の表を参考にして適切な値に置き換えます。

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]

    例:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Assembly /Overwrite /Source:"C:\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    パラメーター 値
    /Applicationname アセンブリを追加する BizTalk アプリケーションの名前。 アプリケーション名が指定されなかった場合、グループの既定の BizTalk アプリケーションが使用されます。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
    /型 System.BizTalk:Assembly (この値では大文字と小文字は区別されません)。
    /上書き 既存のアセンブリを更新するためのオプション。 指定しなかった場合、追加するアセンブリと同じ完全名のアセンブリが既にアプリケーションに存在した場合、AddResource 操作は失敗します。 完全名には、アセンブリ ファイルの名前、バージョン、カルチャ、および公開キー トークンが含まれます。 ListApp コマンドを使用して、アプリケーション内の成果物の LUID を表示できます。
    /ソース アセンブリ ファイルの完全パス (ファイル名を含む)。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
    /先 アプリケーションを .msi ファイルからインストールしたときにアセンブリ ファイルがコピーされる場所 (完全パス)。 指定しなかった場合、インストール中、アセンブリ ファイルはローカル ファイル システムにコピーされません。 パスにスペースが含まれる場合は、パスを二重引用符 (") で囲む必要があります。 RegasmOnInstall または RegsvcsOnInstall オプションを指定した場合は、Destination も指定する必要があります。 メモ： パスで %BTAD_InstallDir% 環境変数を使用できます。 この環境変数は、アプリケーションのインストール フォルダーの値を、アプリケーションのインストール時に受け取ります。 このように、コピー先を指定する際には、アプリケーションのインストール フォルダーのパスを知る必要はありません。 例: %BTAD_InstallDir%\Assemblies\Orchestrations.dll
    /オプション - GacOnAdd: AddResource 操作中に、ローカル コンピューターのグローバル アセンブリ キャッシュ (GAC) にアセンブリをインストールします。
    - GacOnInstall: アプリケーションが .msi ファイルからインストールされるときに、アセンブリを GAC にインストールします。
    - GacOnImport: アプリケーション .msi ファイルのインポート時にアセンブリを GAC にインストールします。
    - RegasmOnInstall: .msi ファイルからアプリケーションをインストールするときに、マネージド COM アセンブリを Windows レジストリに追加します。 このオプションを指定した場合は、Destination も指定する必要があります。
    - RegsvcsOnInstall:アプリケーションが .msi ファイルからインストールされるときに、マネージド COM+ アセンブリを Windows レジストリに追加します。 このオプションを指定した場合は、Destination も指定する必要があります。

    複数のオプションを入力する場合は、コンマで区切って入力します。
    /サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。

    インスタンス名の指定は、そのインスタンス名がサーバー名と異なる場合にのみ必要です。 ポートの指定は、SQL Server で使用するポート番号が既定値 (1433) と異なる場合にのみ必要です。

    例 :

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    指定しなかった場合、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。
    /データベース BizTalk 管理データベースの名前。 指定しなかった場合、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。

参照

.NET アセンブリ、証明書、およびその他のリソースの管理
AddResource コマンド: .NET アセンブリ
BizTalk アプリケーションの作成と変更