AddResource コマンド: BizTalk バインド
BizTalk アプリケーションにバインド ファイルを追加するには、AddResource コマンドを使用し、Type パラメーターに System.BizTalk:BizTalkBinding を指定します。 バインド ファイルを追加するときに、展開環境を指定できます。 後でアプリケーションをインポートするときに、この展開環境を選択して、バインドを適用できます。 バインド ファイルはいくつでも BizTalk アプリケーションに追加できます。また、バインド ファイルは、各種の展開環境に合わせてカスタマイズできます。 複数のバインド ファイルを追加するには、追加する各ファイルについて、このコマンドを実行します。
「ExportBindings コマンド」の説明に従って、アセンブリ、アプリケーション、またはグループ用にエクスポートしたバインド ファイルを追加し、AddResource コマンドを使用してバインド ファイルをアプリケーションに追加できます。
このコマンドを実行すると、バインド ファイルが BizTalk 管理データベースに追加され、このファイルがアプリケーションの Resources フォルダーに表示されます。 さらに、 ListApp コマンドを使用すると、ファイルが一覧表示されます。 バインド ファイルのインポートとは異なり、バインド ファイルを追加しても、既存のバインドはすぐには変更されません。 アプリケーションが他の BizTalk グループにインポートされて初めて、バインドが適用されます。
バインド ファイルを追加するときに、オプションの /Property パラメーター ("TargetEnvironment") を使用して、バインド ファイルの展開環境を指定できます。 このパラメーターの値に、バインド ファイルの適用先の展開環境を表す任意の文字列 (Test や Production など) を指定できます。 /Property パラメーターの値を指定しない場合は、既定値<>が自動的に指定され、アプリケーションがインポートされるたびにこのバインド ファイルが適用されます。
このようにして明示的に追加したバインド ファイルが、インポートするアプリケーションに含まれる場合、/Property パラメーターの値を指定することにより、適用するバインド ファイルを選択できます。 バインドは、アプリケーションのインポート時に適用されます。
インポート プロセスでバインドが適用されるとき、同じ名前を持つ適用済みのバインドは、新しいバインドで上書きされます。 つまり、同じ名前のバインドを適用すると、常に、最新のバインドが有効になります。 複数のバインド ファイルを使用する場合は注意が必要です。 重複するエントリが存在する場合、適用された最新のバインドが有効になります。 アプリケーションをインポートすると、バインドは次の順序で適用されます。
BizTalk Server によって生成されたアプリケーション バインドのうち、バインド ファイルでアプリケーションに明示的に追加されたバインドではなく、ユーザーがアプリケーション .msi ファイルへのエクスポート対象として明示的に選択したバインド。
明示的に追加されたバインド ファイルのうち、対象の展開環境が指定されていないもの。 この一連のバインド内での適用順序は特に決まっていません。
明示的に追加されたバインドのうち、対象の (アプリケーションのインポート用に選択された展開環境と一致する) 展開環境が関連付けられているもの。 この一連のバインド内での適用順序は特に決まっていません。
詳細については、「 BizTalk アプリケーションをインポートする方法」を参照してください。 バインド ファイルの使用に関する背景情報については、「バインド ファイル とアプリケーションの展開」を参照してください。
使用
BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding/Property:TargetEnvironment="value" [/Overwrite] /Source:value [/Server:value] [/Database:value]
パラメーター
| パラメーター | 必須 | 値 |
|---|---|---|
| /ApplicationName (または /A、解説を参照) | いいえ | バインド ファイルを追加する BizTalk アプリケーションの名前。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 アプリケーション名が指定されなかった場合、既定の BizTalk アプリケーションが使用されます。 |
| /Type (または /T、解説を参照) | はい | System.BizTalk:BizTalkBinding (この値では大文字と小文字は区別されません)。 |
| /Source (または /So、解説を参照) | はい | バインド ファイルの完全パス (ファイル名を含む)。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 |
| /Property:TargetEnvironment= (または /P:TargetEnvironment=, 「解説」を参照) | いいえ | 対象の展開環境を指定する文字列。 "Production" など、任意の文字列を使用できます。 例: /Property:TargetEnvironment="Production" 指定しない場合は、Default> の<値が自動的に適用されます。 この値では、大文字と小文字を区別します。 値にスペースが含まれる場合は、二重引用符 (") で囲む必要があります。 環境値の最大長は 128 文字です。 |
| /Overwrite (または /Ov、解説を参照) | いいえ | 既存のバインド ファイルを更新するためのオプション。 指定しなかった場合、追加するバインド ファイルと同じ名前のバインド ファイルが既にアプリケーションに存在した場合、AddResource 操作は失敗します。 |
| /Server (または /Se、解説を参照) | いいえ | BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。 インスタンス名の指定は、そのインスタンス名がサーバー名と異なる場合にのみ必要です。 ポートの指定は、SQL Server で使用するポート番号が既定値 (1433) と異なる場合にのみ必要です。 例 : Server=MyServer Server=MyServer\MySQLServer,1533 指定しなかった場合、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。 |
| /Database (または /Da、解説を参照) | いいえ | BizTalk 管理データベースの名前。 指定しない場合は、SQL Serverのローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。 |
サンプル
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkBinding /Property:TargetEnvironment=Test /Source:"C:\Binding Files\MyBinding.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
注釈
プロパティ名では大文字と小文字が区別されます。 パラメーターの大文字と小文字は区別されません。 パラメーター名は、すべて入力する必要はありません。最初の数文字 (一意に特定できるだけの文字数) を入力するだけで構いません。