Befehle zum Verwalten der Infrastruktur

Mit den Konfigurationsbefehlen im BAM-Verwaltungsdienstprogramm (BM) kann die BAM-Konfiguration abgerufen und aktualisiert werden.

• get-config: Ruft die BAM-Konfigurationsdatei ab.

• update-config: Updates der BAM-Konfiguration.

• get-changes: Listet Änderungen an der BAM-Infrastruktur auf.

• get-defxml: Ruft eine Datei ab, die alle Artefakte in der primären BAM-Importdatenbank enthält.

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 "get-config"

Verwendung

bm.exe get-config -FileName:<output file> [ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter	BESCHREIBUNG
Dateiname:<Ausgabedatei>	Der Pfad und der Dateiname, unter dem die Konfigurationsdatei gespeichert werden soll.
Server:<Server>	Optional: Der Name des Servers, von dem die Konfiguration 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 Konfiguration abgerufen werden soll. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Ruft das BAM-Konfigurations-XML ab und speichert es in der angegebenen Datei. Der Befehl get-config überschreibt die vorhandene Datei nicht.

Beispiele

bm.exe get-config -FileName:MyConfig.xml  
bm.exe get-config -FileName:BAMConfiguration.xml -Server:OrdersServer  

Befehl "update-config"

Verwendung

bm.exe update-config -FileName:<config file>

Parameter

Parameter	BESCHREIBUNG
Dateiname:<Config-Datei>	Der Pfad und der Name der Konfigurationsdatei, aus der die BAM-Infrastruktur aktualisiert werden soll.

Aktualisiert die Konfiguration auf dem lokalen Computer mithilfe einer Datei, die das BAM-Konfigurations-XML enthält. Sie können Server- und Datenbanknamen hinzufügen, die noch nicht in der aktuellen Konfiguration vorhanden sind. Server- oder Datenbanknamen, die bereits in einer dynamischen Infrastruktur bereitgestellt wurden, können nicht geändert werden. Versuche dieser Art schlagen fehl, und bm.exe meldet einen Fehler.

Wenn Sie den Dateiablage-Speicherort für Benachrichtigungen in Dateiform ändern, müssen Sie SQL Notification Services neu starten. Wenn der Notification Services-Dienst nicht neu gestartet wird, werden Benachrichtigungen weiterhin an den ursprünglichen Dateiablage-Speicherort übermittelt.

Den Dateiablage-Speicherort ändern Sie, indem die folgende Zeile der BAM-Konfigurationsdatei ändern.

<Property Name="FileDropUNC">\\<Computername>\alerts</Property>

Entsprechende Schritte zum Aktualisieren der Verweise finden Sie unter Sichern und Wiederherstellen von BizTalk Server.

Wichtig

Wenn Sie beim Ausführen des Befehls "update-database" eine BAM-Konfigurationsdatei verwenden, die keinen Benachrichtigungsabschnitt enthält, und wenn Sie BAM-Benachrichtigungen bereits konfiguriert haben, wird die Konfiguration von bm.exe so überschrieben, dass Benachrichtigungen nicht mehr funktionieren.

Beispiele

bm.exe update-config -FileName:MyConfig.xml  

Befehl "get-changes"

Verwendung

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

Parameter

Parameter	BESCHREIBUNG
Server:<Server>	Optional: Der Name des Servers, auf dem sich die primäre BAM-Importdatenbank 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: Wenn der Name nicht angegeben ist, verwendet bm.exe den Standardnamen BamPrimaryImport.

Ruft eine Liste der auf die primäre BAM-Importdatenbank angewendeten Änderungen ab. Mit diesem Befehl können Sie die Änderungen der BAM-Infrastruktur überwachen. Der Befehl gibt die folgenden Informationen zurück:

Den Befehlstyp der Änderung und die Datei, aus der die Änderung angewendet wurde.

Informationen dazu, von wem die Änderung vorgenommen wurde.

Informationen dazu, welche Aktivitäten geändert wurden.

Informationen dazu, welche Ansichten geändert wurden.

Beispiele

bm.exe get-changes  

Befehlsausgabe

Nr. 1: Bereitstellen von c:\bam\ordermanagement.xml

By domain\user at 12/30/2005 8:17:08 PM (v3.5.1536.0).

Aktivitäten: OrderMgmt

Ansichten: SalesManager

Befehl "get-defxml"

Verwendung

bm.exe get-defxml -FileName:<output file>[ -Server:<server> ][ -Database:<database> ]

Parameter

Parameter	BESCHREIBUNG
Dateiname:<Ausgabedatei>	Der Pfad und Name der Datei, in der die Definitionen gespeichert werden sollen.
Server:<Server>	Optional: Der Name des Servers, von dem die Definitionen abgerufen werden sollen. 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 Definitionen abgerufen werden sollen. Wenn der Name nicht angegeben ist, wird der Standardname „BamPrimaryImport“ verwendet.

Ruft alle Elemente aus der primären BAM-Importdatenbank ab und speichert sie als XML in einer Datei. Vorhandene Dateien werden durch diesen Befehl nicht überschrieben.

Beispiele

bm.exe get-defxml -FileName:BAMDefinition.xml  
bm.exe get-defxml -FileName:MyDef.xml -Server:MyServer -Database:MyPI  

Weitere Informationen

BAM-Verwaltungshilfsprogramm