Perintah Manajemen Pencegat

Untuk mendukung fungsionalitas pencegat BAM baru, empat perintah baru telah ditambahkan ke utilitas Manajemen BAM.

Perintah ini mendukung penyebaran, pengambilan, dan penghapusan pencegat. Perintah juga disediakan untuk mencantumkan pencegat yang dikonfigurasi.

• deploy-interceptor: Menyebarkan konfigurasi pencegat.

• get-interceptorlist: Mendapatkan daftar aktivitas tempat intersepsi disebarkan.

• get-interceptor: Mendapatkan konfigurasi pencegat.

• remove-interceptor: Menghapus konfigurasi pencegat.

Catatan

Anda dapat mengaktifkan pelacakan pada perintah utilitas BM apa pun dengan menyertakan sakelar parameter -Trace:on|off . Menggunakan sakelar Pelacakan akan menggantikan pengaturan pelacakan dalam file konfigurasi. Sakelar dapat digunakan bersama dengan perintah BM normal.

Catatan

Pada sistem yang mendukung Kontrol Akun Pengguna (UAC), Anda mungkin perlu menjalankan alat dengan hak istimewa Administratif.

Perintah deploy-interceptor

Penggunaan

bm.exe deploy-interceptor -FileName:<Configuration XML Filename> [-Force:True ] [-Server:<server>] [-Database:<database>]

Parameter

Parameter	Deskripsi
FileName:<Configuration XML Filename>	Nama file XML yang berisi konfigurasi pencegat.
Force:True	Opsional: Memaksa penyebaran konfigurasi pencegat saat tabrakan nama sumber peristiwa terdeteksi.
Server:<server>	Opsional: Nama server untuk menyebarkan pencegat. Server harus berada di domain yang sama dengan komputer tempat Anda menjalankan bm.exe.
Database:<database>	Opsional: Nama database Impor Utama BAM untuk mengonfigurasi pencegat.

Perintah ini menyebarkan konfigurasi pencegat ke server dan database yang ditentukan. Selama penyebaran, utilitas MANAJEMEN BAM melakukan validasi berikut:

• Validasi XSD: Konfigurasi pencegat divalidasi terhadap skema konfigurasi pencegat umum.

• Validasi bahwa aktivitas ada (disebarkan dalam database Impor Utama) dan bahwa titik pemeriksaan valid (ada dan memiliki jenis data yang cocok).

  Jika tabrakan terdeteksi dalam nama sumber peristiwa, peringatan akan dilemparkan yang menjelaskan tabrakan. Dalam kasus tabrakan, penyebaran akan gagal kecuali bendera parameter –Force:True digunakan.

Catatan

Parameter –Force:True berpotensi menghapus konfigurasi pencegat yang mereferensikan sumber peristiwa dengan nama yang sama. Anda harus menggunakan perintah get-interceptor untuk membuat cadangan konfigurasi pencegat yang ada sebelum menggunakan parameter –Force:True .

Contoh

bm.exe deploy-interceptor  -FileName:myInceptor.xml  
bm.exe deploy-interceptor  -FileName:myInceptor.xml -Force:True  

perintah get-interceptorlist

Penggunaan

bm.exe get-interceptorlist [-Server:<server>] [-Database:<database>]

Parameter

Parameter	Deskripsi
Server:<server>	Opsional: Nama server tempat mengembalikan daftar pencegat yang disebarkan. Server harus berada di domain yang sama dengan komputer tempat Anda menjalankan bm.exe.
Database:<database>	Opsional: Nama database Impor Utama BAM untuk mengambil pencegat yang disebarkan.

Perintah ini mengembalikan daftar aktivitas, dan sumber peristiwa terkait, yang intersepsinya diaktifkan.

Contoh

bm.exe get-interceptorlist   

Perintah get-interceptor

Penggunaan

bm.exe get-interceptor [-Server:<server>] [-Database:<database>] -FileName: <Configuration XML Filename> [ -Activity: <Activity Name>] [-EventSource: <Event Source Name>]

Parameter

Parameter	Deskripsi
Server:<server>	Opsional: Nama server untuk mengambil pencegat yang disebarkan. Server harus berada di domain yang sama dengan komputer tempat Anda menjalankan bm.exe.
Database:<database>	Opsional: Nama database Impor Utama BAM untuk mengambil pencegat yang disebarkan.
FileName:<Configuration XML Filename>	Nama file XML untuk menulis konfigurasi pencegat.
Aktivitas:<Nama Aktivitas>	Opsional: Menentukan aktivitas untuk mengembalikan pencegat yang dikonfigurasi. Dapat digunakan bersama dengan parameter EventSource untuk menentukan konfigurasi yang akan dikembalikan lebih lanjut.
EventSource:<Nama Sumber Peristiwa>	Opsional: Menentukan sumber peristiwa untuk mengembalikan pencegat yang dikonfigurasi. Dapat digunakan bersama dengan parameter Aktivitas untuk menentukan lebih lanjut konfigurasi yang akan dikembalikan.

Jika tidak ada nama aktivitas atau nama sumber peristiwa yang disediakan, perintah mengembalikan file konfigurasi yang valid yang berisi konfigurasi pencegat untuk semua sumber peristiwa dan aktivitas.

Jika hanya nama aktivitas yang disediakan, perintah mengembalikan file konfigurasi pencegat yang valid untuk semua sumber peristiwa untuk aktivitas tersebut.

Jika hanya nama sumber peristiwa yang disediakan, perintah mengembalikan file konfigurasi pencegat yang valid untuk sumber peristiwa tersebut di semua aktivitas.

Jika nama aktivitas dan nama sumber peristiwa disediakan, maka perintah mengembalikan file konfigurasi pencegat yang valid untuk sumber peristiwa tersebut untuk aktivitas tersebut.

Contoh

bm.exe get-interceptor   
bm.exe get-interceptor  -Activity:ShippingPO  

perintah remove-interceptor

Penggunaan

bm.exe remove-interceptor [-Server:<server>] [-Database:<database>] [ -Activity: <Activity Name>][-EventSource: <Event Source Name>]

Parameter

Parameter	Deskripsi
Server:<server>	Opsional: Nama server tempat pencegat dikonfigurasi. Server harus berada di domain yang sama dengan komputer tempat Anda menjalankan bm.exe.
Database:<database>	Opsional: Nama database tempat pencegat dikonfigurasi.
Aktivitas: <Nama Aktivitas>	Opsional: Menentukan aktivitas untuk menghapus pencegat yang ditentukan. Dapat digunakan bersama dengan parameter EventSource untuk menentukan konfigurasi yang akan dikembalikan lebih lanjut.
EventSource: <Nama Sumber Peristiwa>	Opsional: Menentukan sumber peristiwa untuk menghapus pencegat yang ditentukan. Dapat digunakan bersama dengan parameter Aktivitas untuk menentukan lebih lanjut konfigurasi yang akan dikembalikan.

Jika hanya nama aktivitas yang disediakan, perintah akan menghapus pencegat untuk semua sumber peristiwa untuk aktivitas tersebut.

Jika hanya nama sumber peristiwa yang disediakan, perintah hanya menghapus bagian sumber peristiwa tersebut untuk semua aktivitas.

Contoh

bm.exe remove-interceptor   

Lihat juga

Utilitas Manajemen BAM