Commandes de gestion des intercepteurs
Pour prendre en charge la nouvelle fonctionnalité d'intercepteur BAM, quatre nouvelles commandes ont été ajoutées à l'utilitaire de gestion de l'analyse BAM.
Ces commandes prennent en charge le déploiement, l'extraction et la suppression des intercepteurs. L'une d'entre elles permet également d'afficher la liste des intercepteur configurés.
deploy-interceptor : déploie une configuration d’intercepteur.
get-interceptorlist : obtient la liste des activités sur lesquelles l’interception est déployée.
get-interceptor : obtient la configuration de l’intercepteur.
remove-interceptor : supprime une configuration d’intercepteur.
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 deploy-interceptor
Utilisation
bm.exe deploy-interceptor -FileName :<Configuration XML Filename> [-Force :True ] [-Server :<server>] [-Database :<database>]
Paramètres
| Paramètre | Description |
|---|---|
| FileName :<Configuration XML Filename> | Nom du fichier XML contenant la configuration d'intercepteur. |
| Force:True | Facultatif : Force le déploiement de la configuration de l’intercepteur lorsque des collisions de nom de source d’événement sont détectées. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel déployer l’intercepteur. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. |
| Base de données :<base de données> | Facultatif : nom de la base de données d’importation principale BAM sur laquelle configurer l’intercepteur. |
Cette commande déploie la configuration d'intercepteur sur la base de données et le serveur spécifiés. Pendant le déploiement, l'utilitaire de gestion de l'analyse BAM effectue les validations suivantes :
Validation XSD : la configuration de l’intercepteur est validée par rapport au schéma de configuration de l’intercepteur commun.
Validation de l'existence de l'activité (déploiement dans la base de données d'importation principale) et de la validité des points de contrôle (existence et type de données correspondant).
En cas de collision dans le nom de la source d'événements, un message d'avertissement décrivant la collision est envoyé. En cas de collision, le déploiement échoue, sauf si l’indicateur de paramètre –Force :True est utilisé.
Notes
Le paramètre –Force :True supprime potentiellement les configurations d’intercepteurs qui référencent des sources d’événements portant le même nom. Vous devez utiliser la commande get-interceptor pour créer une sauvegarde des configurations d’intercepteur existantes avant d’utiliser le paramètre –Force :True .
Exemples
bm.exe deploy-interceptor -FileName:myInceptor.xml
bm.exe deploy-interceptor -FileName:myInceptor.xml -Force:True
Commande get-interceptorlist
Utilisation
bm.exe get-interceptorlist [-Server :<server>] [-Database :<database>]
Paramètres
| Paramètre | Description |
|---|---|
| Serveur :<serveur> | Facultatif : nom du serveur à partir duquel renvoyer une liste d’intercepteurs déployés. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. |
| Base de données :<base de données> | Facultatif : nom de la base de données d’importation principale BAM à partir de laquelle récupérer les intercepteurs déployés. |
Cette commande retourne une liste des activités, et des sources d'événements associés, pour lesquelles l'interception est activée.
Exemple
bm.exe get-interceptorlist
Commande get-interceptor
Utilisation
bm.exe get-interceptor [-Server :<server>] [-Database :<database>] -FileName : <Configuration XML Filename> [ -Activity : <Activity Name>] [-EventSource : <Event Source Name>]
Paramètres
| Paramètre | Description |
|---|---|
| Serveur :<serveur> | Facultatif : nom du serveur à partir duquel récupérer l’intercepteur déployé. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. |
| Base de données :<base de données> | Facultatif : nom de la base de données d’importation principale BAM à partir de laquelle récupérer l’intercepteur déployé. |
| FileName :<Configuration XML Filename> | Nom du fichier XML dans lequel écrire la configuration d'intercepteur. |
| Activité :<Nom de l’activité> | Facultatif : spécifie l’activité pour laquelle retourner l’intercepteur configuré. Peut être utilisé conjointement avec le paramètre EventSource pour spécifier davantage la configuration à retourner. |
| EventSource :<Event Source Name> | Facultatif : spécifie la source d’événement pour laquelle retourner l’intercepteur configuré. Peut être utilisé conjointement avec le paramètre Activity pour spécifier davantage la configuration à retourner. |
Si aucun nom d'activité ou de source d'événements n'est spécifié, la commande retourne un fichier de configuration valide contenant la configuration d'intercepteur pour l'ensemble des activités et sources d'événements.
Si seul un nom d'activité est spécifié, la commande retourne un fichier de configuration d'intercepteur valide pour l'ensemble des sources d'événements associées à cette activité.
Si seul un nom de source d'événements est spécifié, la commande retourne un fichier de configuration d'intercepteur valide pour cette source d'événements sur l'ensemble des activités.
Si un nom d'activité et un nom de source d'événements sont spécifiés, la commande retourne un fichier de configuration d'intercepteur valide pour cette source d'événements associée à cette activité.
Exemples
bm.exe get-interceptor
bm.exe get-interceptor -Activity:ShippingPO
Commande remove-interceptor
Utilisation
bm.exe remove-interceptor [-Server :<server>] [-Database :<database>] [ -Activity : <Activity Name>][-EventSource : <Event Source Name>]
Paramètres
| Paramètre | Description |
|---|---|
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel l’intercepteur est configuré. Le serveur doit se trouver dans le même domaine que l'ordinateur à partir duquel bm.exe est exécuté. |
| Base de données :<base de données> | Facultatif : nom de la base de données sur laquelle l’intercepteur est configuré. |
| Activité : <Nom de l’activité> | Facultatif : spécifie l’activité pour laquelle supprimer l’intercepteur spécifié. Peut être utilisé conjointement avec le paramètre EventSource pour spécifier davantage la configuration à retourner. |
| EventSource : <Nom de la source de l’événement> | Facultatif : spécifie la source d’événement pour laquelle supprimer l’intercepteur spécifié. Peut être utilisé conjointement avec le paramètre Activity pour spécifier davantage la configuration à retourner. |
Si seul un nom d'activité est spécifié, la commande supprime l'intercepteur pour l'ensemble des sources d'événements associées à cette activité.
Si seul un nom de source d'événements est spécifié, la commande supprime uniquement cette partie de source d'événements pour l'ensemble des activités.
Exemple
bm.exe remove-interceptor