次の方法で共有

COM コンポーネントをアプリケーションに追加する方法

このトピックでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、COM コンポーネントを BizTalk アプリケーションに追加する方法について説明します。

COM コンポーネントをアプリケーションに追加する場合は、次の重要な点に注意してください。

  • アプリケーションに既に存在する COM コンポーネントを上書きする場合は、[上書き] オプションを指定します。 上書きオプションは、両方の成果物が同じローカル一意識別子 (LUID) を持つ場合にのみ必要です。 指定されていない場合、追加する LUID と同じ LUID を持つ COM コンポーネントがアプリケーションに既に存在する場合、追加操作は失敗します。 ListApp コマンドを使用すると、アプリケーション内の成果物の LUID を表示できます。

  • BizTalk Server では、COM コンポーネントの依存関係が存在することを確認しないため、コンポーネントが依存する成果物が存在することを確認する必要があります。

  • 64 ビットのアンマネージ COM または COM+ コンポーネントを追加し、COM または COM+ コンポーネントを含むアプリケーションを 32 ビット コンピューターにインストールしようとすると、コンポーネントはインストールされません。 64 ビット コンピューターにのみインストールされます。

[前提条件]

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

COM コンポーネントをアプリケーションに追加するには

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

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

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

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

  4. [ 追加] をクリックし、COM コンポーネントを選択して、[ 開く] をクリックします。

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

  6. [オプション] で、アプリケーションのインストール時にコンポーネントを Windows レジストリに追加するかどうかに応じて、[宛先にファイルを登録する (regsvr32)] チェック ボックスをオンまたはオフにします。

  7. [宛先] に、アプリケーションが .msi ファイルからインストールされるときに COM コンポーネントがコピーされる場所の完全なパス (ファイル名を含む) を入力します。 このパスが指定されていない場合、インストール時にファイルはローカル ファイル システムにコピーされません。 このパスは、前の手順 で [宛先にファイルを登録する (regsvr32)] チェック ボックスをオンにした場合に必要です。

    例: %BTAD_InstallDir%\MyComponent.dll

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

コマンド ラインの使用

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

  2. 次の表に示すように、適切な値に置き換えて、次のコマンドを入力します。

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Com [/Overwrite] /Source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]

    例：

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Com /Overwrite /Source:"C:\Source Components\COM.dll" /Destination:"C:\New Components\COM.dll" /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    パラメーター 価値
    /ApplicationName COM コンポーネントを追加する BizTalk アプリケーションの名前。 アプリケーション名が指定されていない場合は、グループの既定の BizTalk アプリケーションが使用されます。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
    /種類 System.BizTalk:Com (この値では大文字と小文字は区別されません)。
    /上書き 既存の COM コンポーネントを更新するオプション。 指定されていない場合、追加する COM コンポーネントと同じ LUID を持つ COM コンポーネントがアプリケーションに既に存在する場合、AddResource 操作は失敗します。 ListApp コマンドを使用すると、アプリケーション内の成果物の LUID を表示できます。
    /源 ファイル名を含む COM コンポーネント .dll ファイルの完全パス。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
    /行き先 アプリケーションが .msi ファイルからインストールされるときに、COM コンポーネント .dll ファイルがコピーされる場所の完全パス。 指定しない場合、インストール時にファイルはローカル ファイル システムにコピーされません。そのため、インストール中にコンポーネントを Windows レジストリに追加することはできません。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 Regsvr32OnInstallOption を指定する場合は、Destination も指定する必要があります。
    /オプション Regsvr32OnInstall. .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 コマンド: COM コンポーネント
BizTalk アプリケーションの作成と変更