Commandes de gestion des activités
Les commandes de gestion des activités de l'utilitaire de gestion de l'analyse BAM permettent de travailler avec des activités déployées.
get-activities : obtient la liste des activités déployées.
remove-activity : supprime une activité.
get-activitywindow : obtient la durée d’une activité.
set-activitywindow : définit la durée d’activité d’une activité.
get-index : obtient la liste des index.
create-index : crée un index.
delete-index : supprime un index.
get-archive : obtient le comportement de l’activité archivée.
set-archive : définit le comportement de l’activité archivée.
Notes
Vous pouvez activer le suivi sur n’importe quelle commande de l’utilitaire BAM 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. L'option peut être utilisée 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-activities
Utilisation
bm.exe get-activities [ -View :<view name> ][ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Nom :<nom de l’activité> | Nom de l'activité à supprimer. |
| Serveur :<serveur> | Facultatif : nom du serveur à partir duquel obtenir la liste des activités. 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 liste des activités. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Répertorie les activités déployées sur l'ordinateur sur lequel la commande est exécutée.
Exemples
bm.exe get-activities -View:SalesManagerView
bm.exe get-activities -Server:MyServer -Database:MyPrimaryImport
Commande remove-activity
Utilisation
bm.exe remove-activity -Name :<activity name>[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Nom :<nom de l’activité> | Nom de l'activité à supprimer. |
| Serveur :<serveur> | Facultatif : nom du serveur à partir duquel supprimer l’activité. 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 supprimer l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Supprime l'activité spécifiée de la base de données d'importation principale BAM. Si l'activité comporte des vues dépendantes, la commande échoue et renvoie une erreur. Utilisez alors la commande remove-view pour supprimer toutes les vues dépendantes, puis réexécutez la commande remove-activity.
Exemples
bm.exe remove-activity -Name:PurchaseOrder
bm.exe remove-activity -Name:PO -Server:MyServer -Database:MyPrimaryImport
Commande get-activitywindow
Utilisation
bm.exe get-activitywindow -Activity :<activity name>[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Activité :<nom de l’activité> | Nom de .activity. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Affiche la durée pour l'activité spécifiée. Cette commande renvoie la valeur de la durée ainsi que son unité de mesure.
Exemples
bm.exe get-activitywindow -Activity:PurchaseOrder
bm.exe get-activitywindow -Activity:PO -Server:Ship -Database:ShipDatabase
Commande set-activitywindow
Utilisation
bm.exe set-activitywindow -Activity :<activity name> -TimeLength :<integer number> -TimeUnit :Month|Jour|Heure|Minute[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Activité :<nom de l’activité> | Nom de l’activité. |
| TimeLength :<nombre entier> | Durée de l'activité. |
| TimeUnit:Month|Day|Hour|Minute | Unité de mesure de la durée. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Définit la durée pour l'activité spécifiée.
Exemples
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:6 -TimeUnit:Day
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:1 -TimeUnit:Month
Commande get-index
Utilisation
bm.exe get-index -Activity :<activity name>[ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| Activité :nom de< l’activité> | Nom de l’activité. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Répertorie tous les index qui ont été créés pour l'activité spécifiée.
Exemples
bm.exe get-index -Activity:PurchaseOrder
bm.exe get-index -Activity:PurchaseOrder -Server:Ship -Database:ShipDatabase
Commande create-index
Utilisation
bm.exe create-index -IndexName :nom de l’index< -Activity :<activity name> -Checkpoint :<checkpoint1>[,<checkpoint2>...]> [ -Server :<server> ][ -Database :<database> ]
Paramètres
| Paramètre | Description |
|---|---|
| IndexName :nom de< l’index> | Nom du nouvel index. |
| Activité :nom de< l’activité> | Nom de l'activité pour laquelle l'index est créé. |
| Point de contrôle :<checkpoint1>[,<point de contrôle2>...] | Liste de points de contrôle délimités par des virgules pour l'index. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Crée un index pour l'activité spécifiée en utilisant les points de contrôle spécifiés.
Exemples
bm.exe create-index -IndexName:Idx1 -Activity:PO -Checkpoint:State,City
bm.exe create-index -IndexName:Idx2 -Activity:PO -Checkpoint:Amount -Server:S1
Commande delete-index
Utilisation
bm.exe delete-index -IndexName :nom de l’index< -Activity :<activity name>[ -Server :<server> ][ -Database :<database> ]>
Paramètres
| Paramètre | Description |
|---|---|
| IndexName :nom de< l’index> | Nom de l’index à supprimer. |
| Activité :nom de< l’activité> | Nom de l'activité pour laquelle l'index est supprimé. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Supprime de l'activité indiquée l'index spécifié à l'aide du nom indiqué.
Exemples
bm.exe delete-index -IndexName:Idx1 -Activity:PO
bm.exe delete-index -IndexName:Idx2 -Activity:PO -Server:S1 -Database:BamPI1
Commande get-archive
Utilisation
bm.exe get-archive -Activity :<activity> [-Server :<server>] [-Database :<database>]
Paramètres
| Paramètre | Description |
|---|---|
| Activité :nom de< l’activité> | Nom de l’activité pour laquelle le comportement doit être affiché. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Obtient le comportement du package d’archivage de l’activité spécifiée, qu’il archive ou qu’il supprime les données de l’activité.
Exemples
bm.exe get-archive -Activity:PurchaseOrder
Commande set-archive
Utilisation
bm.exe set-archive -Activity :<activity> -ShouldArchive :True [-Server :<server>] [-Database :<database>]
Paramètres
| Paramètre | Description |
|---|---|
| Activité :nom de< l’activité> | Nom de l’activité pour laquelle le comportement doit être affiché. |
| ShouldArchive : True | Si ce paramètre a la valeur True, l’activité est déplacée dans la base de données d’archivage. En revanche, s’il a la valeur False, l’activité est supprimée. |
| Serveur :<serveur> | Facultatif : nom du serveur sur lequel réside l’activité. 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 sur laquelle réside l’activité. Si le nom n'est pas spécifié, bm.exe utilise le nom par défaut BamPrimaryImport. |
Définit le comportement du package d’archivage de l’activité spécifiée pour que les données de cette dernière soient déplacées dans la base de donnés d’archivage. Par défaut, ce comportement est défini pour les nouvelles activités déployées.
Exemples
Pour purger les données de l’activité BAM, exécutez la commande suivante :
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:False
Pour déplacer les données de l’activité BAM vers la base de données d’archivage BAM, exécutez la commande suivante :
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:True