活動管理命令
BAM 管理公用程式活動管理命令可讓您使用已部署的活動。
get-activities：取得已部署活動的清單。
remove-activity：移除活動。
get-activitywindow：取得活動的持續時間。
set-activitywindow：設定活動的活動持續時間。
get-index：取得索引清單。
create-index：建立新的索引。
delete-index：刪除索引。
get-archive：取得封存活動的行為。
set-archive：設定封存活動的行為。
注意
您可以在任何 BAM 公用程式命令上啟用追蹤，方法是包含 -Trace：on|off 參數參數參數。 使用追蹤參數會覆寫組態檔中的追蹤設定。 此參數可以搭配任何一般 BAM 命令使用。
注意
在支援使用者帳戶控制 (UAC) 的系統上，您可能需要使用系統管理權限來執行工具。
get-activities 命令
使用方式
bm.exe get-activities [ -View：view name ][ -Server： << server > ][ -Database： < database > ] >
參數
| 參數 | Description |
|---|---|
| Name： < activity name> | 要移除的活動名稱。 |
| Server： < server> | 選擇性：要從中取得活動清單的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：要從中取得活動清單的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
列出在執行此命令之電腦上部署的活動。
範例
bm.exe get-activities -View:SalesManagerView
bm.exe get-activities -Server:MyServer -Database:MyPrimaryImport
remove-activity 命令
使用方式
bm.exe remove-activity -Name： < activity name > [ -Server： < server > ][ -Database： < database > ]
參數
| 參數 | Description |
|---|---|
| Name： < activity name> | 要移除的活動名稱。 |
| Server： < server> | 選擇性：要從中移除活動的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：要從中移除活動的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
從 BAM 主要匯入資料庫移除指定的活動。 如果活動有相依檢視，命令將會失敗並報告錯誤。 請先使用 remove-view 命令移除所有相依檢視，然後再度執行 remove-activity 命令。
範例
bm.exe remove-activity -Name:PurchaseOrder
bm.exe remove-activity -Name:PO -Server:MyServer -Database:MyPrimaryImport
get-activitywindow 命令
使用方式
bm.exe get-activitywindow -Activity：activity name[ -Server： << server > ][ -Database： < database > ] >
參數
| 參數 | Description |
|---|---|
| Activity： < activity name> | 活動的名稱。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
顯示指定活動的持續時間。 這個命令會傳回持續時間的長度以及測量持續時間所用的單位。
範例
bm.exe get-activitywindow -Activity:PurchaseOrder
bm.exe get-activitywindow -Activity:PO -Server:Ship -Database:ShipDatabase
set-activitywindow 命令
使用方式
bm.exe set-activitywindow -Activity： < activity name > -TimeLength：integer number > -TimeUnit： < Month|Day|Hour|Minute[ -Server： < server > ][ -Database： < database > ]
參數
| 參數 | Description |
|---|---|
| Activity： < activity name> | 活動名稱。 |
| TimeLength： < integer number> | 活動的持續時間。 |
| TimeUnit:Month|Day|Hour|Minute | 持續時間的計量單位。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
設定指定活動的持續時間。
範例
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:6 -TimeUnit:Day
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:1 -TimeUnit:Month
get-index 命令
使用方式
bm.exe get-index -Activity： < activity name > [ -Server： < server > ][ -Database： < database > ]
參數
| 參數 | Description |
|---|---|
| Activity： < activity name> | 活動名稱。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
列出已針對指定之活動建立的所有索引。
範例
bm.exe get-index -Activity:PurchaseOrder
bm.exe get-index -Activity:PurchaseOrder -Server:Ship -Database:ShipDatabase
create-index 命令
使用方式
bm.exe create-index -IndexName： < index name -Activity： < activity name >> -Checkpoint： < checkpoint1 > [， < checkpoint2 > ...][ -Server： < server > ][ -Database： < database > ]
參數
| 參數 | Description |
|---|---|
| IndexName： < index name> | 新索引的名稱。 |
| Activity： < activity name> | 建立索引的活動名稱。 |
| Checkpoint： < checkpoint1 > [， < checkpoint2 > ...] | 索引的檢查點清單 (以逗號分隔)。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
使用指定的檢查點，為指定的活動建立索引。
範例
bm.exe create-index -IndexName:Idx1 -Activity:PO -Checkpoint:State,City
bm.exe create-index -IndexName:Idx2 -Activity:PO -Checkpoint:Amount -Server:S1
delete-index 命令
使用方式
bm.exe delete-index -IndexName：index name -Activity： << activity name >> [ -Server：server > ][ -Database： << database > ]
參數
| 參數 | Description |
|---|---|
| IndexName： < index name> | 要刪除之索引的名稱。 |
| Activity： < activity name> | 要刪除索引之活動的名稱。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
從指定的活動刪除具有指定名稱的指定索引。
範例
bm.exe delete-index -IndexName:Idx1 -Activity:PO
bm.exe delete-index -IndexName:Idx2 -Activity:PO -Server:S1 -Database:BamPI1
get-archive 命令
使用方式
bm.exe get-archive -Activity：activity [-Server： << server > ] [-Database： < database > ] >
參數
| 參數 | Description |
|---|---|
| Activity： < activity name> | 要顯示行為的活動名稱。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
取得指定活動的封存封裝行為，不論封存套件是否會封存或購買活動資料。
範例
bm.exe get-archive -Activity:PurchaseOrder
set-archive 命令
使用方式
bm.exe set-archive -Activity： < activity > -ShouldArchive：True [-Server：server > ] [-Database： << database > ]
參數
| 參數 | Description |
|---|---|
| Activity： < activity name> | 要顯示行為的活動名稱。 |
| ShouldArchive：True | 如果設定為 True，活動會移至封存資料庫。 如果設定為 False，則會清除活動。 |
| Server： < server> | 選擇性：活動所在的伺服器名稱。 伺服器和執行 bm.exe 的電腦必須位在相同網域中。 如果沒有指定伺服器名稱，bm.exe 會使用 localhost 的預設名稱。 |
| Database： < database> | 選擇性：活動所在的資料庫名稱。 如果沒有指定名稱，bm.exe 會使用預設的名稱 BamPrimaryImport。 |
設定指定之活動的封存封裝行為，讓活動資料移至封存資料庫。 根據預設，系統會針對已部署的新活動設定此行為。
範例
若要清除 BAM 活動資料，請執行下列動作：
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:False
若要將 BAM 活動資料移至 BAMArchive 資料庫，請執行下列動作：
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:True