Perintah AddResource: BizTalk Assembly
Untuk menambahkan rakitan BizTalk ke aplikasi BizTalk, Anda menggunakan perintah AddResource dan menentukan System.BizTalk:BizTalkAssembly untuk parameter Jenis. Menjalankan perintah ini menambahkan rakitan ke database BizTalk Management. Rakitan juga ditampilkan di konsol Administrasi BizTalk Server, di folder Sumber Daya aplikasi tempat Anda menambahkannya. Artefak yang disertakan dalam rakitan juga ditampilkan di folder yang sesuai. Selain itu, artefak dicantumkan saat Anda menggunakan Perintah ListApp.
Saat menggunakan perintah ini, ingatlah poin-poin berikut:
Jika rakitan memiliki nama lengkap yang sama dengan rakitan yang sudah ada dalam aplikasi, Anda harus menentukan parameter Timpa atau operasi AddResource akan gagal. Nama lengkapnya terdiri dari nama, token kunci publik, budaya, dan versi. Namun, jika aplikasi lain bergantung pada rakitan ini, operasi AddResource akan gagal bahkan jika Anda menentukan parameter Timpa.
Jika rakitan lain yang memiliki nama lengkap yang sama ada dalam grup, operasi AddResource akan gagal, bahkan jika Anda menentukan parameter Timpa.
Jika Anda menimpa rakitan yang berisi orkestrasi, orkestrasi harus dihentikan dan tidak tercantum sebelum Anda menjalankan perintah ini. Selain itu, port pengiriman tempat orkestrasi terikat harus dihentikan dan tidak tercantum, dan lokasi penerima dinonaktifkan.
Jika rakitan yang Anda tambahkan memiliki dependensi pada artefak lain yang tidak disertakan dalam aplikasi, operasi AddResource akan gagal.
Untuk informasi selengkapnya tentang dependensi, lihat Dependensi dan Penyebaran Aplikasi.
Penggunaan
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/Server:value] [/Database:value]
Parameter
| Parameter | Diperlukan | Nilai |
|---|---|---|
| /ApplicationName (atau /A, lihat Keterangan) | Tidak | Nama aplikasi BizTalk yang akan ditambahkan ke assembly. Jika nama menyertakan spasi, Anda harus mengapitnya dalam tanda kutip ganda ("). Jika nama aplikasi tidak ditentukan, aplikasi BizTalk default akan digunakan. |
| /Type (atau /T, lihat Remarks) | Ya | System.BizTalk:BizTalkAssembly (Nilai ini tidak peka huruf besar/kecil.) |
| /Overwrite (atau /Ov, lihat Remarks) | Tidak | Opsi untuk memperbarui rakitan yang ada. Jika tidak ditentukan, dan rakitan sudah ada di aplikasi yang memiliki nama lengkap yang sama dengan rakitan yang ditambahkan, operasi AddResource gagal. Nama lengkap sesuai dengan pengidentifikasi unik lokal (LUID) untuk perakitan. Anda dapat melihat LUID untuk artefak dalam aplikasi dengan menggunakan Perintah ListApp. Jika aplikasi lain bergantung pada assembly yang ditimpa, operasi AddResource gagal, bahkan ketika parameter ini ditentukan. |
| /Source (atau /So, lihat Remarks) | Ya | Jalur lengkap file assembly, termasuk nama file. Jika jalur menyertakan spasi, Anda harus mengapitnya dalam tanda kutip ganda ("). |
| /Destination (atau /De, lihat Remarks) | Tidak | Jalur lengkap lokasi tempat file assembly akan disalin ketika aplikasi diinstal dari file .msi. Jika tidak disediakan, file assembly tidak disalin ke sistem file lokal selama penginstalan. Jika jalur menyertakan spasi, Anda harus mengapitnya dalam tanda kutip ganda ("). Catatan: Anda dapat menggunakan variabel lingkungan %BTAD_InstallDir%, yang diatur selama penginstalan BizTalk Server, untuk menentukan folder penginstalan aplikasi. Ini akan membuat lokasi yang konsisten untuk file aplikasi di komputer tujuan yang berbeda. Contoh: "%BTAD_InstallDir%\MyFiles\Orchestrations.dll" |
| /Options (atau /Op, lihat Remarks) | Tidak |
-
GacOnAdd: Tentukan untuk menginstal rakitan ke cache rakitan global (GAC) di komputer lokal selama operasi AddResource. - GacOnInstall: Tentukan untuk menginstal rakitan ke GAC saat aplikasi diinstal dari file .msi. - GacOnImport: Tentukan untuk menginstal rakitan ke GAC saat aplikasi .msi file diimpor. Anda harus memisahkan beberapa opsi dengan koma. |
| /Server (atau /Se, lihat Keterangan) | Tidak | Nama instans SQL Server yang menghosting database Manajemen BizTalk, dalam bentuk ServerName\InstanceName,Port. Nama instans hanya diperlukan ketika nama instans berbeda dari nama server. Port hanya diperlukan ketika SQL Server menggunakan nomor port selain default (1433). Contoh: Server=MyServer Server=MyServer\MySQLServer,1533 Jika tidak disediakan, nama instans SQL Server yang berjalan di komputer lokal digunakan. |
| /Database (atau /Da, lihat Keterangan) | Tidak | Nama database BizTalk Management. Jika tidak ditentukan, database BizTalk Management yang berjalan dalam instans lokal SQL Server digunakan. |
Sampel
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite
/Source:"%BTAD_InstallDir%\Source Assemblies\Orchestrations.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\Orchestrations.dll" /Options:GacOnInstall,GacOnImport /Server:MyDatabaseServer /Database:BizTalkMgmtDb
Keterangan
Parameter tidak peka huruf besar/kecil. Anda tidak perlu mengetikkan seluruh nama parameter untuk menentukannya; Anda dapat mengetik beberapa huruf pertama dari nama parameter yang mengidentifikasinya secara tidak ambigu.
Lihat juga
Perintah AddResource
Cara Menambahkan BizTalk Assembly ke Aplikasi