Freigeben über


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  

Weitere Informationen

BAM-Verwaltungshilfsprogramm