攔截器管理命令
為了支援新的 BAM 攔截器功能，BAM 管理公用程式中已加入四個新的命令。
這些命令支援攔截器的部署、擷取和移除。 也有提供一個命令給設定的攔截器清單。
deploy-interceptor：部署攔截器組態。
get-interceptorlist：取得部署攔截的活動清單。
get-interceptor：取得攔截器組態。
remove-interceptor：移除攔截器組態。
注意
您可以在任何 BM 公用程式命令上啟用追蹤，方法是包含 -Trace：on|off 參數參數參數。 使用追蹤參數會覆寫組態檔中的追蹤設定。 此參數可以搭配任何一般 BM 命令使用。
注意
在支援使用者帳戶控制 (UAC) 的系統上，您可能需要使用系統管理權限來執行工具。
deploy-interceptor 命令
使用方式
bm.exe deploy-interceptor -FileName：Configuration XML Filename [-Force： < True ] [-Server： < server > ] [-Database： < database > ] >
參數
| 參數 | Description |
|---|---|
| FileName： < Configuration XML Filename> | 包含攔截器組態的 XML 檔案名稱。 |
| Force:True | 選擇性：偵測到事件來源名稱衝突時，強制部署攔截器組態。 |
| Server： < server> | 選擇性：要在其中部署攔截器的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 |
| Database： < database> | 選擇性：要設定攔截器的 BAM 主要匯入資料庫名稱。 |
這個命令會將攔截器組態部署到指定的伺服器和資料庫。 在部署期間，BAM 管理公用程式會執行下列驗證：
XSD 驗證：攔截器設定會根據常見的攔截器組態架構進行驗證。
此活動存在 (在主要匯入資料庫中部署) 且檢查點有效 (存在而且有相符的資料類型) 的驗證。
如果在事件來源名稱中偵測到衝突，會擲回一則警告來描述此衝突。 在發生衝突的情況下，除非使用 –Force：True 參數旗標，否則部署將會失敗。
注意
–Force：True參數可能會移除參考相同名稱之事件來源的攔截器組態。 使用–Force：True參數之前，您應該使用get-interceptor命令來建立現有攔截器組態的備份。
範例
bm.exe deploy-interceptor -FileName:myInceptor.xml
bm.exe deploy-interceptor -FileName:myInceptor.xml -Force:True
get-interceptorlist 命令
使用方式
bm.exe get-interceptorlist [-Server： < server > ] [-Database： < database > ]
參數
| 參數 | Description |
|---|---|
| Server： < server> | 選擇性：要從中傳回已部署攔截器清單的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 |
| Database： < database> | 選擇性：要從中擷取已部署攔截器之 BAM 主要匯入資料庫的名稱。 |
這個命令會傳回已啟用攔截之活動和其相關事件來源的清單。
範例
bm.exe get-interceptorlist
get-interceptor 命令
使用方式
bm.exe get-interceptor [-Server：server] [-Database： << database > ] -FileName： < Configuration XML Filename > [ -Activity： < Activity Name > ] [-EventSource： < Event Source Name > ] >
參數
| 參數 | Description |
|---|---|
| Server： < server> | 選擇性：要從中擷取已部署攔截器的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 |
| Database： < database> | 選擇性：要從中擷取已部署攔截器之 BAM 主要匯入資料庫的名稱。 |
| FileName： < Configuration XML Filename> | 寫入攔截器組態的目標 XML 檔案名稱。 |
| Activity： < Activity Name> | 選擇性：指定要傳回已設定攔截器的活動。 可以與 EventSource 參數搭配使用，以進一步指定要傳回的組態。 |
| EventSource： < 事件來源名稱> | 選擇性：指定要傳回已設定攔截器的事件來源。 可以與 Activity 參數搭配使用，以進一步指定要傳回的組態。 |
如果未提供任何活動名稱或事件來源名稱，此命令會傳回有效的組態檔，其中包含所有事件來源和活動的攔截器組態。
如果只有提供活動名稱，此命令會針對該活動的所有事件來源傳回有效的攔截器組態檔。
如果只有提供事件來源名稱，此命令會針對所有活動中的該事件來源傳回有效的攔截器組態檔。
如果活動名稱和事件來源名稱都有提供，此命令會針對該活動的該事件來源傳回有效的攔截器組態檔。
範例
bm.exe get-interceptor
bm.exe get-interceptor -Activity:ShippingPO
remove-interceptor 命令
使用方式
bm.exe remove-interceptor [-Server：server] [-Database： << database > ] [ -Activity： < Activity Name > ][-EventSource： Event Source Name <> ] >
參數
| 參數 | Description |
|---|---|
| Server： < server> | 選擇性：設定攔截器的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 |
| Database： < database> | 選擇性：設定攔截器的資料庫名稱。 |
| 活動： < 活動名稱> | 選擇性：指定要移除指定攔截器的活動。 可以與 EventSource 參數搭配使用，以進一步指定要傳回的組態。 |
| EventSource： < 事件來源名稱> | 選擇性：指定要移除指定攔截器的事件來源。 可以與 Activity 參數搭配使用，以進一步指定要傳回的組態。 |
如果只有提供活動名稱，此命令會針對該活動的所有事件來源移除攔截器。
如果只有提供事件來源名稱，此命令只會移除所有活動的該事件來源部分。
範例
bm.exe remove-interceptor