Perintah AddResource: Pengikatan BizTalk
Untuk menambahkan file pengikatan ke aplikasi BizTalk, Anda menggunakan perintah AddResource dan menentukan System.BizTalk:BizTalkBinding untuk parameter Type . Saat menambahkan file pengikatan, Anda dapat menentukan lingkungan penyebaran untuk file tersebut. Ketika nanti Anda mengimpor aplikasi, Anda dapat memilih lingkungan penyebaran ini untuk menerapkan pengikatan. Anda dapat menambahkan sejumlah file pengikatan ke aplikasi BizTalk, masing-masing yang disesuaikan untuk lingkungan penyebaran yang berbeda. Anda menambahkan beberapa file pengikatan dengan menjalankan perintah ini untuk setiap file yang akan ditambahkan.
Anda dapat menambahkan file pengikatan yang Anda ekspor untuk rakitan, aplikasi, atau grup, seperti yang dijelaskan dalam Perintah ExportBindings, lalu menggunakan perintah AddResource untuk menambahkan file pengikatan ke aplikasi.
Menjalankan perintah ini menambahkan file pengikatan ke database Manajemen BizTalk, dan file ditampilkan di folder Sumber Daya aplikasi. Selain itu, file dicantumkan saat Anda menggunakan Perintah ListApp. Tidak seperti mengimpor file pengikatan, menambahkan file pengikatan tidak segera mengubah pengikatan yang ada. Pengikatan tidak diterapkan sampai aplikasi diimpor ke grup BizTalk lain.
Saat menambahkan file pengikatan, Anda dapat menentukan lingkungan penyebarannya dengan menggunakan parameter opsional "TargetEnvironment" /Property. Nilainya bisa berupa string apa pun yang mewakili lingkungan penyebaran tempat Anda ingin menerapkan pengikatan dalam file ini, seperti Pengujian atau Produksi. Jika Anda tidak menentukan nilai untuk parameter /Property, nilai <Default> ditentukan secara otomatis, dan file pengikatan ini akan diterapkan setiap kali aplikasi diimpor.
Saat Anda mengimpor aplikasi yang menyertakan satu atau beberapa file pengikatan yang telah Anda tambahkan secara eksplisit dengan cara ini, Anda dapat memilih file atau file pengikatan mana yang akan diterapkan dengan menentukan nilai parameter /Property. Pengikatan diterapkan pada impor aplikasi.
Karena pengikatan diterapkan selama proses impor, pengikatan yang telah diterapkan ditimpa oleh pengikatan baru yang memiliki nama yang sama. Dengan kata lain, pengikatan terakhir nama tertentu yang akan diterapkan berlaku. Ketahui hal ini saat menggunakan beberapa file pengikatan. Jika berisi entri duplikat, pengikatan terbaru yang diterapkan akan berlaku. Saat Anda mengimpor aplikasi, pengikatan diterapkan dalam urutan berikut:
Pengikatan aplikasi yang dihasilkan oleh BizTalk Server yang tidak secara eksplisit ditambahkan ke aplikasi melalui file pengikatan, tetapi itu secara eksplisit dipilih oleh pengguna untuk diekspor ke file .msi aplikasi.
Mengikat file yang telah ditambahkan secara eksplisit, dan tidak memiliki lingkungan penyebaran target yang ditentukan. Pengikatan dalam set ini diterapkan tanpa urutan tertentu.
Pengikatan yang telah ditambahkan secara eksplisit, dan yang memiliki lingkungan penyebaran target terkait yang cocok dengan lingkungan penyebaran yang dipilih untuk impor aplikasi. Pengikatan dalam set ini diterapkan tanpa urutan tertentu.
Untuk informasi selengkapnya, lihat Cara Mengimpor Aplikasi BizTalk. Untuk informasi latar belakang tentang menggunakan file pengikatan, lihat Mengikat File dan Penyebaran Aplikasi.
Penggunaan
BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding/Property:TargetEnvironment="value" [/Overwrite] /Source:value [/Server:value] [/Database:value]
Parameter
| Parameter | Diperlukan | Nilai |
|---|---|---|
| /ApplicationName (atau /A, lihat Komentar) | Tidak | Nama aplikasi BizTalk untuk menambahkan file pengikatan. 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:BizTalkBinding (Nilai ini tidak peka huruf besar/kecil.) |
| /Source (atau /So, lihat Remarks) | Ya | Jalur lengkap file pengikatan, termasuk nama file. Jika jalur menyertakan spasi, Anda harus mengapitnya dalam tanda kutip ganda ("). |
| /Property:TargetEnvironment= (atau /P:TargetEnvironment=, lihat Komentar) | Tidak | String yang menentukan lingkungan penyebaran target. Anda dapat menggunakan string apa pun, misalnya Produksi. Contoh: /Property:TargetEnvironment="Production" Jika tidak ditentukan, nilai <Default> akan diterapkan secara otomatis. Nilai ini peka huruf besar/kecil. Jika nilai menyertakan spasi, Anda harus mengapitnya dalam tanda kutip ganda ("). Panjang maksimum nilai lingkungan adalah 128 karakter. |
| /Overwrite (atau /Ov, lihat Remarks) | Tidak | Opsi untuk memperbarui file pengikatan yang ada. Jika tidak ditentukan, dan file pengikatan sudah ada di aplikasi yang memiliki nama file yang sama dengan file yang ditambahkan, operasi AddResource gagal. |
| /Server (atau /Se, lihat Komentar) | 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 Komentar) | Tidak | Nama database BizTalk Management. Jika tidak disediakan, database BizTalk Management yang berjalan dalam instans lokal SQL Server digunakan. |
Sampel
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkBinding /Property:TargetEnvironment=Test /Source:"C:\Binding Files\MyBinding.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
Keterangan
Nama properti peka huruf besar/kecil. Parameter tidak peka huruf besar/kecil. Anda tidak perlu mengetik 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 File Pengikatan ke Aplikasi