次の方法で共有

.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 オプションを指定する場合は、宛先も指定する必要があります。 手記： パスで %BTAD_InstallDir% 環境変数を使用できます。 アプリケーションのインストール時に、アプリケーションのインストール フォルダーの値を受け取ります。 この方法では、移動先の場所を指定するときに、アプリケーション インストール フォルダーのパスを知る必要はありません。 例: %BTAD_InstallDir%\Assemblies\Orchestrations.dll
    /オプション - GacOnAdd: AddResource 操作中に、ローカル コンピューターのグローバル アセンブリ キャッシュ (GAC) にアセンブリをインストールします。
    - GacOnInstall: .msi ファイルからアプリケーションをインストールするときに、アセンブリを GAC にインストールします。
    - GacOnImport: アプリケーション .msi ファイルのインポート時にアセンブリを GAC にインストールします。
    - RegasmOnInstall: .msi ファイルからアプリケーションをインストールするときに、マネージド COM アセンブリを Windows レジストリに追加します。 このオプションを指定する場合は、宛先も指定する必要があります。
    - RegsvcsOnInstall:.msi ファイルからアプリケーションをインストールするときに、マネージド COM+ アセンブリを Windows レジストリに追加します。 このオプションを指定する場合は、宛先も指定する必要があります。

    複数のオプションはコンマで区切る必要があります。
    /サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前 。ServerName\InstanceName,Port という形式です。

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

    例：

    Server=MyServer

    Server=MyServer\MySQLServer,1533

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

こちらもご覧ください

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