次の方法で共有


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

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

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

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

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

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

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

Von Bedeutung

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

ただし、仮想ディレクトリが既に移行先環境に存在する場合は、既存の仮想ディレクトリのセキュリティ設定が有効になります。 これらは、デプロイする仮想ディレクトリ上のものと一致するように変更されません。 この場合は、既存の仮想ディレクトリのセキュリティ設定が要件を満たしていることを確認する必要があります。

注意事項

仮想ディレクトリで HTTPS (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 アプリケーションの作成と変更