AddResource コマンド: .NET アセンブリ
.NET アセンブリ (マネージド COM または COM+ コンポーネントを含む) を BizTalk アプリケーションに追加するには、 AddResource コマンドを使用し、Type パラメーターに System.BizTalk:Assembly を指定します。 このコマンドを実行すると、該当するアセンブリが BizTalk 管理データベースに追加されます。 このアセンブリは、BizTalk 管理コンソール (追加先アプリケーションの Resources フォルダー) にも表示されます。 さらに、 ListApp コマンドを使用すると、アセンブリが一覧表示されます。
アプリケーションに同じ完全名の既存のアセンブリが存在する場合は、Overwrite パラメーターを指定できます。 完全名は、名前、公開キー トークン、カルチャ、およびバージョンから成ります。 この場合、既存のアセンブリは上書きされます。 依存関係の詳細については、「 依存関係とアプリケーションのデプロイ」を参照してください。
使用
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly[/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]
パラメーター
| パラメーター | 必須 | 値 |
|---|---|---|
| /ApplicationName (または /A、解説を参照) | いいえ | アセンブリを追加する BizTalk アプリケーションの名前。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 アプリケーション名が指定されなかった場合、グループの既定の BizTalk アプリケーションが使用されます。 |
| /Type (または /T、解説を参照) | はい | System.BizTalk:Assembly (この値では大文字と小文字は区別されません)。 |
| /Overwrite (または /Ov、解説を参照) | いいえ | 既存のアセンブリを更新するためのオプション。 指定しなかった場合、追加するアセンブリと同じ完全名のアセンブリが既にアプリケーションに存在した場合、AddResource 操作は失敗します。 完全名には、アセンブリ名、バージョン、カルチャ、および公開キー トークンが含まれます。 この情報は、BizTalk Server 管理コンソール (アプリケーションのリソース フォルダーの "名前" フィールド) に表示されます。 |
| /Source (または /So、解説を参照) | はい | アセンブリ ファイルの完全パス (ファイル名を含む)。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 |
| /Destination (または /De、解説を参照) | いいえ | アプリケーションを .msi ファイルからインストールしたときにアセンブリ ファイルがコピーされる場所 (完全パス)。 指定しなかった場合、インストール中、アセンブリ ファイルはローカル ファイル システムにコピーされません。 パスにスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 RegasmOnInstall または RegsvcsOnInstall オプションを指定した場合は、Destination も指定する必要があります。 メモ： %BTAD_InstallDir% 環境変数を使用して、アプリケーションのインストール フォルダーを指定できます。 これにより、異なるターゲット コンピューター上のアプリケーションのファイルの一貫性のある場所が作成されます。 例: "%BTAD_InstallDir%\MyAssemblies\Orchestrations.dll" |
| /Options (または /Op、解説を参照) | いいえ | - GacOnAdd: AddResource 操作中に、ローカル コンピューターのグローバル アセンブリ キャッシュ (GAC) にアセンブリをインストールします。 - GacOnInstall: アプリケーションが .msi ファイルからインストールされるときに、アセンブリを GAC にインストールします。 - GacOnImport: アプリケーション .msi ファイルのインポート時にアセンブリを GAC にインストールします。 - RegasmOnInstall: .msi ファイルからアプリケーションをインストールするときに、マネージド COM アセンブリを Windows レジストリに追加します。 このオプションを指定した場合は、Destination も指定する必要があります。 - RegsvcsOnInstall:アプリケーションが .msi ファイルからインストールされるときに、マネージド COM+ アセンブリを Windows レジストリに追加します。 このオプションを指定した場合は、Destination も指定する必要があります。 複数のオプションを入力する場合は、コンマで区切って入力します。 コンマと値の間にスペースは挿入しません。 |
| /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:Assembly /Overwrite /Source:"%BTAD_InstallDir%\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb
注釈
パラメーターの大文字と小文字は区別されません。 パラメーター名は、すべて入力する必要はありません。最初の数文字 (一意に特定できるだけの文字数) を入力するだけで構いません。