ImportBindings コマンド

XML ベースのバインド ファイルから、BizTalk アプリケーションまたはグループにバインドをインポートします。 バインディングは、「バインディングのエクスポート」で説明されているように、アセンブリ、アプリケーション、またはグループから エクスポートされている可能性があります。 バインドがどこからエクスポートされたかによって、ApplicationName パラメーターと GroupLevel パラメーターの作用が異なります。 詳細については、後の「解説」を参照してください。

Note

BizTalk Serverで生成されたバインド ファイルには、アプリケーションが指定されていません。 これらは、既定のアプリケーションにインポートされます。

使用

BTSTask ImportBindings -Source:value [-GroupLevel-ApplicationName | :value] [-Server:value] [-Database:value] [-ImportTrackingSettings:value] [-ExcludeParties]

パラメーター

パラメーター	必須	値
-Source (または -So、解説を参照)	必須	インポートするバインド ファイルの完全パス (ファイル名を含む)。 パスにスペースが含まれる場合は、二重引用符 (") で囲む必要があります。
-GroupLevel (または -G、解説を参照)	省略可能	バインド ファイルを現在のグループにインポートするためのオプション。 このパラメーターを指定した場合は、/ApplicationName は指定しません。
-ApplicationName (または -A、解説を参照)	Optional	バインドをインポートする BizTalk アプリケーションの名前。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 アプリケーションが存在している必要があります。アプリケーションが存在しない場合、インポート操作は失敗します。 このパラメーターを指定しなかった場合、既定の BizTalk アプリケーションが使用されます。 このパラメーターを指定した場合は、/GroupLevel は指定しません。
-Server (または -Se、解説を参照)	省略可能	BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。 インスタンス名の指定は、そのインスタンス名がサーバー名と異なる場合にのみ必要です。 ポートの指定は、SQL Server で使用するポート番号が既定値 (1433) と異なる場合にのみ必要です。 例 : Server=MyServer Server=MyServer\MySQLServer,1533 指定しなかった場合、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。
-Database (または -D、解説を参照)	Optional	BizTalk 管理データベースの名前。 指定しなかった場合、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。
-ImportTrackingSettings	省略可能	BizTalk Server 2016 以降の新機能。 これにより、グローバル追跡設定のインポート オプションがオーバーライドされます。 "true" 値を指定すると、追跡設定をインポートできます。 False を指定すると、設定のインポートの追跡が禁止されます。
-ExcludeParties	省略可能	BizTalk Server 2016 以降の新機能。 指定すると、バインド ファイルからパーティ情報が除外されます。

サンプル

次のコマンドは、既定の BizTalk グループの MyApplication というアプリケーションにバインドをインポートします。

BTSTask ImportBindings -ApplicationName:MyApplication -Source:C:\Bindings\Binding1.xml

次のコマンドは、SQL Server インスタンス (MY_Server) 上で実行されている BizTalk 管理データベースで定義されたグループにバインドをインポートします。

BTSTask ImportBindings -GroupLevel -Server:MY_Server -Database:BiztalkMgmtDb -Source:C:\Bindings\Binding1.xml

注釈

パラメーターの大文字と小文字は区別されません。 パラメーター名は、すべて入力する必要はありません。最初の数文字 (一意に特定できるだけの文字数) を入力するだけで構いません。

バインドのエクスポート元としては、アセンブリ、アプリケーション、グループが考えられます。 次の表に示すように、ApplicationName パラメーターと GroupLevel パラメーターの作用は、バインドがどこからエクスポートされたかによって異なります。

バインドのエクスポート元	ApplicationName パラメーターの作用	GroupLevel パラメーターの作用
アセンブリからエクスポートされたバインド	ApplicationName で指定されたアプリケーションには、バインド ファイルのエクスポート元アセンブリと同じ名前のアセンブリが含まれている必要があります。 それ以外の場合、インポート操作が失敗します。	現在のグループには、バインド ファイルのエクスポート元のアセンブリおよびアプリケーションと同じ名前のアセンブリおよびアプリケーションが含まれている必要があります。 それ以外の場合、インポートは失敗します。
アプリケーションからエクスポートされたバインド	バインド ファイルのエクスポート元アプリケーションは、ApplicationName で指定されたアプリケーションと同じ名前であることが必要です。 それ以外の場合、インポート操作が失敗します。	バインド ファイルのエクスポート元アプリケーションは、バインドをインポートするグループのアプリケーションと同じ名前であることが必要です。 それ以外の場合、インポート操作が失敗します。
グループからエクスポートされたバインド	バインド ファイルのエクスポート元グループには、ApplicationName で指定されたアプリケーションと同じ名前のアプリケーションが存在していることが必要です。 それ以外の場合、インポート操作が失敗します。	バインドのインポートは、対応するアプリケーション間で行われます。 つまり、エクスポート元グループにおけるアプリケーションのバインドは、現在のグループで同じ名前を持つアプリケーションにインポートされます。

参照

BTSTask コマンド ライン リファレンス
BizTalk グループにバインドをインポートする方法
BizTalk アプリケーションにバインドをインポートする方法