Befehle zum Verwalten des Interceptors

Zur Unterstützung der neuen BAM-Interceptorfunktionen wurde das BAM-Verwaltungsdienstprogramm um vier neue Befehle erweitert.

Mit diesen Befehlen können Interceptors bereitgestellt, abgerufen und entfernt werden. Weiterhin steht ein Befehl zum Auflisten aller konfigurierten Interceptors zur Verfügung.

• deploy-interceptor: Stellt eine Interceptorkonfiguration bereit.

• get-interceptorlist: Ruft eine Liste der Aktivitäten ab, für die interception bereitgestellt wird.

• get-interceptor: Ruft die Interceptorkonfiguration ab.

• remove-interceptor: Entfernt eine Interceptorkonfiguration.

Hinweis

Sie können die Ablaufverfolgung für jeden BM-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 in Verbindung mit jedem normalen BM-Befehl 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 „deploy-interceptor“

Verwendung

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

Parameter

Parameter	BESCHREIBUNG
FileName:<Configuration XML Filename>	Der Name der XML-Datei mit der Interceptorkonfiguration.
Force:True	Optional: Erzwingt die Bereitstellung der Interceptorkonfiguration, wenn Konflikte mit dem Ereignisquellennamen erkannt werden.
Server:<Server>	Optional: Der Name des Servers, auf dem der Interceptor bereitgestellt werden soll. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen.
Datenbank:<Datenbank>	Optional: Der Name der primären BAM-Importdatenbank, für die der Interceptor konfiguriert werden soll.

Mit diesem Befehl wird die Interceptorkonfiguration für den angegebenen Server und die angegebene Datenbank bereitgestellt. In der Bereitstellungsphase führt das BAM-Verwaltungsdienstprogramm folgende Überprüfungen aus:

• XSD-Überprüfung: Die Interceptorkonfiguration wird anhand des allgemeinen Interceptorkonfigurationsschemas überprüft.

• Überprüfung, ob die Aktivität vorhanden ist (d. h. in der primären Importdatenbank bereitgestellt ist) und die Prüfpunkte gültig sind (d. h. vorhanden sind und über übereinstimmende Datentypen verfügen).

  Bei Konflikten im Ereignisquellennamen wird eine Warnmeldung mit einer Beschreibung des Konflikts ausgelöst. Im Falle einer Kollision schlägt die Bereitstellung fehl, es sei denn, das Parameterflag –Force:True wird verwendet.

Hinweis

Der Parameter –Force:True entfernt möglicherweise Interceptorkonfigurationen, die auf Ereignisquellen mit demselben Namen verweisen. Sie sollten den Befehl get-interceptor verwenden, um eine Sicherung vorhandener Interceptorkonfigurationen zu erstellen, bevor Sie den Parameter –Force:True verwenden.

Beispiele

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

Befehl „get-interceptorlist“

Verwendung

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

Parameter

Parameter	BESCHREIBUNG
Server:<Server>	Optional: Der Name des Servers, von dem eine Liste der bereitgestellten Interceptors zurückgegeben werden soll. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen.
Datenbank:<Datenbank>	Optional: Der Name der primären BAM-Importdatenbank, aus der die bereitgestellten Interceptors abgerufen werden sollen.

Mit diesem Befehl wird eine Liste der Aktivitäten und der zugeordneten Ereignisquellen zurückgegeben, für die die Interceptorfunktion aktiviert ist.

Beispiel

bm.exe get-interceptorlist   

Befehl „get-interceptor“

Verwendung

bm.exe get-interceptor [-Server:<server] [-Database:<database>] -FileName: <Konfigurations-XML-Dateiname> [ -Activity: <Aktivitätsname>] [-EventSource: <Ereignisquellenname>>]

Parameter

Parameter	BESCHREIBUNG
Server:<Server>	Optional: Der Name des Servers, von dem der bereitgestellte Interceptor abgerufen werden soll. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen.
Datenbank:<Datenbank>	Optional: Der Name der primären BAM-Importdatenbank, aus der der bereitgestellte Interceptor abgerufen werden soll.
FileName:<Configuration XML Filename>	Der Name der XML-Datei, in die die Interceptorkonfiguration geschrieben werden soll.
Aktivität:<Aktivitätsname>	Optional: Gibt die Aktivität an, für die der konfigurierte Interceptor zurückgegeben werden soll. Kann in Verbindung mit dem EventSource-Parameter verwendet werden, um die zurückzugebende Konfiguration weiter anzugeben.
EventSource:<Name der Ereignisquelle>	Optional: Gibt die Ereignisquelle an, für die der konfigurierte Interceptor zurückgegeben werden soll. Kann in Verbindung mit dem Activity-Parameter verwendet werden, um die zurückzugebende Konfiguration weiter anzugeben.

Wenn kein Aktivitäts- oder Ereignisquellenname angegeben wird, gibt der Befehl eine gültige Konfigurationsdatei zurück, in der die Interceptorkonfigurationen für alle Ereignisquellen und Aktivitäten enthalten sind.

Wenn nur ein Aktivitätsname angegeben wird, gibt der Befehl eine gültige Interceptorkonfigurationsdatei für alle Ereignisquellen dieser Aktivität zurück.

Wenn nur ein Ereignisquellenname angegeben wird, gibt der Befehl eine gültige Interceptorkonfigurationsdatei für diese Ereignisquelle in allen Aktivitäten zurück.

Wenn sowohl ein Aktivitäts- als auch ein Ereignisquellenname angegeben wird, gibt der Befehl eine gültige Interceptorkonfigurationsdatei für diese Ereignisquelle dieser Aktivität zurück.

Beispiele

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

Befehl „remove-interceptor“

Verwendung

bm.exe remove-interceptor [-Server:<server>] [-Database:<database>] [ -Activity: <Aktivitätsname>][-EventSource: <Name der Ereignisquelle>]

Parameter

Parameter	BESCHREIBUNG
Server:<Server>	Optional: Der Name des Servers, auf dem der Interceptor konfiguriert ist. Der Server muss sich in derselben Domäne wie der Computer befinden, auf dem Sie bm.exe ausführen.
Datenbank:<Datenbank>	Optional: Der Name der Datenbank, für die der Interceptor konfiguriert ist.
Aktivität: <Aktivitätsname>	Optional: Gibt die Aktivität an, für die der angegebene Interceptor entfernt werden soll. Kann in Verbindung mit dem EventSource-Parameter verwendet werden, um die zurückzugebende Konfiguration weiter anzugeben.
EventSource: <Name der Ereignisquelle>	Optional: Gibt die Ereignisquelle an, für die der angegebene Interceptor entfernt werden soll. Kann in Verbindung mit dem Activity-Parameter verwendet werden, um die zurückzugebende Konfiguration weiter anzugeben.

Wenn nur ein Aktivitätsname angegeben wird, entfernt der Befehl den Interceptor für alle Ereignisquellen dieser Aktivität.

Wenn nur ein Ereignisquellenname angegeben wird, entfernt der Befehl nur diesen Teil der Ereignisquelle für alle Aktivitäten.

Beispiel

bm.exe remove-interceptor   

Weitere Informationen

BAM-Verwaltungshilfsprogramm