次の方法で共有

仮想ディレクトリをアプリケーションに追加する方法

  • [アーティクル]

このトピックでは、BTSTask コマンド ライン ツールを使用して BizTalk アプリケーションに仮想ディレクトリを追加する方法について説明します。 このオプションは、BizTalk Server 管理コンソールでは利用できません。 カスタム Web サービスを記述するか、BizTalk Server とのインターフェイス用に ASP.NET Web サイトを作成して、アプリケーションに仮想ディレクトリを展開する場合、仮想ディレクトリを追加できます。

アプリケーションに仮想ディレクトリを追加するもう 1 つの方法は、「HTTP 受信場所を構成する方法」で説明されているように、SOAP または HTTP 受信場所の仮想ディレクトリを指定することです。 いずれの場合も、仮想ディレクトリは BizTalk 管理データベースに追加されます。 コマンド ラインを使用して仮想ディレクトリを追加すると、BizTalk Server管理コンソール、追加先のアプリケーションの Resources フォルダー、および ListApp コマンドを使用するときのアプリケーション内の成果物の一覧にも表示されます。 後でアプリケーションをエクスポートして別の BizTalk グループにインポートした場合、仮想ディレクトリはその [リソース] フォルダーに表示されます。

仮想ディレクトリをアプリケーションに追加する際には、次の点に注意してください。

  • 上書きオプションを指定することで、アプリケーションに既に存在する仮想ディレクトリを上書きできます。 上書きオプションは、既存の仮想ディレクトリの名前が追加する仮想ディレクトリと同じ場合にのみ必要です。 指定せず、追加する仮想ディレクトリと同じ名前の仮想ディレクトリがアプリケーションに既に存在する場合、追加操作は失敗します。

  • URL に https が含まれる仮想ディレクトリを追加する場合、URL には https ではなく http を使用する必要があります。 https を使用した場合、仮想ディレクトリの追加操作は失敗します。 URL に http を指定したとしても、インターネット インフォメーション サービス メタベースでは、依然として、その URL の https 設定が有効であるため、仮想ディレクトリは正常に機能します。

  • 64 ビット版の Web サービスから仮想ディレクトリを追加し、その仮想ディレクトリを含むアプリケーションを 32 ビット コンピューターにインストールしようとしても、仮想ディレクトリはインストールされません。 64 ビット コンピューターにインストールする必要があります。

重要

仮想ディレクトリを含むアプリケーションをインポートすると、仮想ディレクトリのセキュリティ設定は、アプリケーションのエクスポートで .msi ファイルが生成されたときに使用されていた設定になります。 アプリケーションを実稼働環境に展開する場合は、アプリケーションをエクスポートする前に、設定がセキュリティの要件を満たしていることを確認してください。

ただし、その仮想ディレクトリが展開先の環境に既に存在する場合は、既存の仮想ディレクトリのセキュリティ設定が有効になります。 展開しようとしている仮想ディレクトリのセキュリティ設定に合わせて変更されることはありません。 この場合は、既存の仮想ディレクトリのセキュリティ設定が要件を満たしているかどうかの確認が必要になります。

注意事項

仮想ディレクトリで HTTPS (Hypertext Transfer Protocol over Secure Socket Layer) プロトコルが使用されている場合、その仮想ディレクトリのセキュリティ設定はエクスポート時に維持されず、インポート時にはルートのセキュリティ設定が継承されます。 したがって、そのセキュリティ設定が要件を満たしているかどうかの確認が必要になります。

前提条件

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

仮想ディレクトリをアプリケーションに追加するには

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

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

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

    例:

    BTSTask AddResource /ApplicationName:MyApplication /Type: System.BizTalk:WebDirectory /Overwrite /Source:http://Host1:90/MyVirtualDirectory /Destination:http://Host2:90/MyVirtualDirectory /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    パラメーター 値
    /Applicationname 仮想ディレクトリを追加する BizTalk アプリケーションの名前。 アプリケーション名が指定されなかった場合、グループの既定の BizTalk アプリケーションが使用されます。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。
    /型 System.BizTalk:WebDirectory (この値では大文字と小文字は区別されません)。
    /上書き 既存の仮想ディレクトリを更新するためのオプション。 指定しなかった場合、追加する仮想ディレクトリと同じ名前の仮想ディレクトリが既にアプリケーションに存在した場合、AddResources 操作は失敗します。
    /ソース コピー元仮想ディレクトリの URI。
    /先 アプリケーションが .msi ファイルからインストールされたときに、仮想ディレクトリに割り当てる URI。 このパラメーターを指定しなかった場合、Source パラメーターの値が localhost と組み合わせて使用されます。
    /サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。

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

    例 :

    Server=MyServer

    Server=MyServer\MySQLServer,1533

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

参照

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