Commandes de gestion d'infrastructure
Les commandes de configuration de l'utilitaire de gestion de l'analyse BAM (BM) vous permettent d'obtenir et de mettre à jour la configuration BAM.
get-config : obtient le fichier de configuration BAM.
update-config : Mises à jour la configuration BAM.
get-changes : répertorie les modifications apportées à l’infrastructure BAM.
get-defxml : obtient un fichier contenant tous les artefacts de la base de données d’importation principale BAM.
Notes
Vous pouvez activer le suivi sur n’importe quelle commande de l’utilitaire BM en incluant le commutateur de paramètre -Trace :on|off . L'utilisation du commutateur de suivi remplace les paramètres de suivi du fichier de configuration. Le commutateur peut être utilisé conjointement avec toute commande BAM classique.
Notes
Sur les systèmes qui prennent en charge le contrôle de compte d'utilisateur, vous devrez peut-être exécuter l'outil avec des privilèges d'administrateur.
Commande get-config
Utilisation
bm.exe get-config -FileName :<output file> [ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| FileName :<output file> | Chemin d'accès et nom de fichier à utiliser pour enregistrer le fichier de configuration. |
| Serveur :<serveur> | Facultatif : nom du serveur à partir duquel obtenir la configuration. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : nom de la base de données à partir de laquelle obtenir la configuration. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Récupère le fichier XML de configuration BAM et l'enregistre dans le fichier spécifié. La commande get-config ne remplace pas le fichier existant.
Exemples
bm.exe get-config -FileName:MyConfig.xml
bm.exe get-config -FileName:BAMConfiguration.xml -Server:OrdersServer
Commande update-config
Utilisation
bm.exe update-config -FileName :<config file>
Paramètres
| Paramètre | Description |
|---|---|
| FileName :<config file> | Chemin d'accès et nom du fichier de configuration à l'aide duquel mettre à jour l'infrastructure BAM. |
Met à jour la configuration de l'ordinateur local à partir d'un fichier XML de configuration BAM. Vous pouvez ajouter des noms de serveur et de base de données qui n'existent pas encore dans la configuration actuelle. La modification des noms de serveur ou de base de données disposant déjà d'une infrastructure dynamique déployée se soldera par un échec et bm.exe signalera une erreur.
Si vous modifiez l'emplacement de dépôt du fichier pour les alertes envoyées sous forme de fichier, vous devez redémarrer les services de notification SQL. Si ces services ne sont pas redémarrés, les alertes continueront à être envoyées à l'emplacement d'origine destiné au dépôt du fichier.
L'emplacement de dépôt du fichier se modifie en changeant la ligne suivante du fichier de configuration BAM.
<Property Name="FileDropUNC">\\<computer name>\alerts</Property>
Pour connaître les étapes appropriées pour mettre à jour les références, consultez Sauvegarde et restauration des BizTalk Server.
Important
Si vous exécutez une commande update-database, avec un fichier de configuration BAM ne contenant pas de section d'alertes, et que vous avez déjà configuré des alertes BAM, bm.exe écrasera la configuration de sorte que les alertes ne fonctionneront plus.
Exemples
bm.exe update-config -FileName:MyConfig.xml
Commande get-changes
Utilisation
bm.exe get-changes [ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside la base de données d’importation principale BAM. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : si le nom n’est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Obtient une liste de modifications appliquées à la base de données d'importation principale BAM. Vous pouvez utiliser cette commande pour vérifier les modifications de l'infrastructure de l'analyse BAM. La commande renvoie les informations suivantes :
Le type de commande de la modification et le fichier à partir duquel la modification a été appliquée.
L'utilisateur ayant appliqué la modification.
Les activités qui ont été modifiées.
Les vues qui ont été modifiées.
Exemples
bm.exe get-changes
Résultat de la commande
#1 : Déployer c:\bam\ordermanagement.xml
By domain\user at 12/30/2005 8:17:08 PM (v3.5.1536.0).
Activités : OrderMgmt
Vues : SalesManager
Commande get-defxml
Utilisation
bm.exe get-defxml -FileName :<output file>[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| FileName :<output file> | Chemin d'accès et nom du fichier dans lequel enregistrer les définitions. |
| Serveur :<serveur> | Facultatif : nom du serveur à partir duquel obtenir les définitions. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. Si le nom du serveur n'est pas spécifié, bm.exe utilise le nom par défaut de l'hôte local. |
| Base de données :<base de données> | Facultatif : nom de la base de données à partir de laquelle obtenir les définitions. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Extrait tous les artefacts de la base de données d'importation principale BAM et les enregistre dans un fichier XML. La commande n'écrase pas les fichiers existants.
Exemples
bm.exe get-defxml -FileName:BAMDefinition.xml
bm.exe get-defxml -FileName:MyDef.xml -Server:MyServer -Database:MyPI