次の方法で共有

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

  • [アーティクル]

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

COM コンポーネントをアプリケーションに追加する際には、次の重要事項を念頭に置いてください。

  • アプリケーションに既に存在する COM コンポーネントを上書きする場合は、[上書き] オプションを指定します。 上書きオプションは、両方のアイテムが同じローカル一意識別子 (LUID) を持つ場合にのみ必要です。 このオプションを指定しない場合、追加する COM コンポーネントと同じ 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 レジストリに追加されます。 このオプションを指定した場合は、Destination も指定する必要があります。
    /サーバー 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 アプリケーションの作成と変更