Befehle zum Verwalten von Aktivitäten
Mithilfe der Befehle zum Verwalten von Aktivitäten für das BAM-Verwaltungshilfsprogramm können Sie mit bereitgestellten Aktivitäten arbeiten.
get-activities: Ruft eine Liste der bereitgestellten Aktivitäten ab.
remove-activity: Entfernt eine Aktivität.
get-activitywindow: Ruft die Dauer für eine Aktivität ab.
set-activitywindow: Legt die Aktivitätsdauer für eine Aktivität fest.
get-index: Ruft die Liste der Indizes ab.
create-index: Erstellt einen neuen Index.
delete-index: Löscht einen Index.
get-archive: Ruft das Verhalten der archivierten Aktivität ab.
set-archive: Legt das Verhalten der archivierten Aktivität fest.
Hinweis
Sie können die Ablaufverfolgung für jeden BAM-Hilfsprogrammbefehl aktivieren, indem Sie den Parameterschalter -Trace:on|off einschließen. Die Ablaufverfolgungseinstellungen in der Konfigurationsdatei werden durch die Verwendung dieser Option überschrieben. Der Schalter kann mit allen normalen BAM-Verwaltungsbefehlen verwendet werden.
Hinweis
Auf einem System, das Unterstützung für die Benutzerkontensteuerung (User Account Control, UAC) bietet, müssen Sie das Tool möglicherweise mit Administratorrechten ausführen.
Befehl „get-activities“
Verwendung
bm.exe get-activities [ -View:<view name> ][ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Name:<Aktivitätsname> | Der Name der Aktivität, die entfernt werden soll. |
| Server:<Server> | Optional: Der Name des Servers, von dem die Liste der Aktivitäten abgerufen werden soll. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, aus der die Liste der Aktivitäten abgerufen werden soll. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Listet die Aktivitäten auf, die auf dem Computer bereitgestellt sind, auf dem der Befehl ausgeführt wird.
Beispiele
bm.exe get-activities -View:SalesManagerView
bm.exe get-activities -Server:MyServer -Database:MyPrimaryImport
Befehl "remove-activity"
Verwendung
bm.exe remove-activity -Name:<Aktivitätsname>[ -Server:<Server> ][ -Datenbank:<Datenbank> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Name:<Aktivitätsname> | Der Name der Aktivität, die entfernt werden soll. |
| Server:<Server> | Optional: Der Name des Servers, von dem die Aktivität entfernt werden soll. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, aus der die Aktivität entfernt werden soll. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Entfernt die angegebene Aktivität aus der primären BAM-Importdatenbank. Wenn die Aktivität abhängige Ansichten besitzt, schlägt der Befehl fehl, und es wird ein Fehler ausgegeben. Verwenden Sie den Befehl remove-view, um alle abhängigen Ansichten zu entfernen, und führen Sie den Befehl remove-activity erneut aus.
Beispiele
bm.exe remove-activity -Name:PurchaseOrder
bm.exe remove-activity -Name:PO -Server:MyServer -Database:MyPrimaryImport
Befehl "get-activitywindow"
Verwendung
bm.exe get-activitywindow -Activity:Activity name<>[ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Aktivität:<Aktivitätsname> | Der Name der AKTIVITÄT. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Zeigt die Dauer der angegebenen Aktivität an. Dieser Befehl gibt die Dauer und die Einheiten zurück, in denen die Dauer gemessen wird.
Beispiele
bm.exe get-activitywindow -Activity:PurchaseOrder
bm.exe get-activitywindow -Activity:PO -Server:Ship -Database:ShipDatabase
Befehl „set-activitywindow“
Verwendung
bm.exe set-activitywindow -Activity:Activity name<> -TimeLength:<integer number> -TimeUnit:Month|Tag|Stunde|Minute[ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Aktivität:<Aktivitätsname> | Der Name der Aktivität. |
| TimeLength:<integer number> | Die Dauer der Aktivität. |
| TimeUnit:Month|Day|Hour|Minute | Die Maßeinheit für die Dauer. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Legt die Dauer für die angegebene Aktivität fest.
Beispiele
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:6 -TimeUnit:Day
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:1 -TimeUnit:Month
Befehl „get-index“
Verwendung
bm.exe get-index -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Aktivität:<Aktivitätsname> | Der Name der Aktivität. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Listet alle Indizes auf, die für die angegebene Aktivität erstellt wurden.
Beispiele
bm.exe get-index -Activity:PurchaseOrder
bm.exe get-index -Activity:PurchaseOrder -Server:Ship -Database:ShipDatabase
Befehl „create-index“
Verwendung
bm.exe create-index -IndexName:<index name> -Activity:<activity name> -Checkpoint:<checkpoint1>[,<checkpoint2>...] [ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| IndexName:<Indexname> | Der Name des neuen Index. |
| Aktivität:<Aktivitätsname> | Der Name der Aktivität, für die der Index erstellt wird. |
| Prüfpunkt:<checkpoint1>[,<checkpoint2>...] | Eine kommagetrennte Liste von Prüfpunkten für den Index. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Erstellt einen Index für die angegebene Aktivität mithilfe der festgelegten Prüfpunkte.
Beispiele
bm.exe create-index -IndexName:Idx1 -Activity:PO -Checkpoint:State,City
bm.exe create-index -IndexName:Idx2 -Activity:PO -Checkpoint:Amount -Server:S1
Befehl „delete-index“
Verwendung
bm.exe delete-index -IndexName:<index name> -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| IndexName:<Indexname> | Der Name des Index, der gelöscht werden soll. |
| Aktivität:<Aktivitätsname> | Der Name der Aktivität, für die der Index gelöscht wird. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Löscht den angegebenen Index mit dem vorgegebenen Namen aus der festgelegten Aktivität.
Beispiele
bm.exe delete-index -IndexName:Idx1 -Activity:PO
bm.exe delete-index -IndexName:Idx2 -Activity:PO -Server:S1 -Database:BamPI1
get-archive-Befehl
Verwendung
bm.exe get-archive -Activity:<activity> [-Server:<server>] [-Database:<database>]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Aktivität:<Aktivitätsname> | Der Name der Aktivität, für die das Verhalten angezeigt werden soll. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Ruft das Verhalten des Archivierungspakets für die angegebene Aktivität ab (ob das Archivierungspaket Aktivitätsdaten archiviert oder bereinigt).
Beispiele
bm.exe get-archive -Activity:PurchaseOrder
Befehl "set-archive"
Verwendung
bm.exe set-archive -Activity:<activity> -ShouldArchive:True [-Server:<server>] [-Database:<database>]
Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| Aktivität:<Aktivitätsname> | Der Name der Aktivität, für die das Verhalten angezeigt werden soll. |
| ShouldArchive: True | Wenn dieser Wert auf Wahr festgelegt ist, wird die Aktivität in die Archivierungsdatenbank verschoben. Ist er auf Falsch festgelegt, wird die Aktivität bereinigt. |
| Server:<Server> | Optional: Der Name des Servers, auf dem sich die Aktivität befindet. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen. Wenn der Servername nicht angegeben ist, wird der Standardname „localhost“ verwendet. |
| Datenbank:<Datenbank> | Optional: Der Name der Datenbank, in der sich die Aktivität befindet. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet. |
Legt das Verhalten des Archivierungspakets für die angegebene Aktivität fest, damit die Aktivitätsdaten in die Archivierungsdatenbank verschoben werden. Standardmäßig wird dieses Verhalten für neue Aktivitäten festgelegt, die bereitgestellt werden.
Beispiele
Führen Sie die folgenden Aktionen aus, um die BAM-Aktivitätsdaten zu bereinigen:
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:False
Führen Sie die folgenden Aktionen aus, um die BAM-Aktivitätsdaten in die BAMArchive-Datenbank zu verschieben:
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:True