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