Comandos de la administración de la actividad
Los comandos de administración de la actividad de la utilidad de administración de BAM permiten trabajar con actividades implementadas.
get-activities: obtiene una lista de actividades implementadas.
remove-activity: quita una actividad.
get-activitywindow: obtiene la duración de una actividad.
set-activitywindow: establece la duración de la actividad de una actividad.
get-index: obtiene la lista de índices.
create-index: crea un nuevo índice.
delete-index: elimina un índice.
get-archive: obtiene el comportamiento de la actividad archivada.
set-archive: establece el comportamiento de la actividad archivada.
Nota
Puede habilitar el seguimiento en cualquier comando de utilidad de BAM incluyendo el modificador de parámetro -Trace:on|off . Al utilizar el conmutador Trace, se invalidan las opciones de seguimiento del archivo de configuración. El conmutador puede usarse junto con cualquier comando normal de BAM.
Nota
En un sistema que admita el Control de cuentas de usuario (UAC), es posible que deba ejecutar la herramienta con privilegios administrativos.
Comando get-activities
Uso
bm.exe get-activities [ -View:<view name> ][ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| Name:<activity name> | Nombre de la actividad que se va a quitar. |
| Server:<server> | Opcional: nombre del servidor desde el que se va a obtener la lista de actividades. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos de la que se va a obtener la lista de actividades. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Enumera las actividades implementadas en el equipo en el que se ejecuta el comando.
Ejemplos
bm.exe get-activities -View:SalesManagerView
bm.exe get-activities -Server:MyServer -Database:MyPrimaryImport
Comando remove-activity
Uso
bm.exe remove-activity -Name:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| Name:<activity name> | Nombre de la actividad que se va a quitar. |
| Server:<server> | Opcional: nombre del servidor del que se va a quitar la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos de la que se va a quitar la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Quita la actividad especificada de la base de datos de importación principal de BAM. Si la actividad tiene vistas dependientes, el comando no funcionará e informará de un error. Utilice el comando remove-view para quitar todas las vistas dependientes y ejecutar de nuevo el comando remove-activity.
Ejemplos
bm.exe remove-activity -Name:PurchaseOrder
bm.exe remove-activity -Name:PO -Server:MyServer -Database:MyPrimaryImport
Comando get-activitywindow
Uso
bm.exe get-activitywindow -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| Activity:<activity name> | Nombre de la .activity. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Muestra la duración de la actividad especificada. El comando recupera la longitud de la duración y las unidades con las que se mide la duración.
Ejemplos
bm.exe get-activitywindow -Activity:PurchaseOrder
bm.exe get-activitywindow -Activity:PO -Server:Ship -Database:ShipDatabase
Comando set-activitywindow
Uso
bm.exe set-activitywindow -Activity:<activity name> -TimeLength:<integer number> -TimeUnit:Month|Día|Hora |Minute[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| Activity:<activity name> | El nombre de la actividad. |
| TimeLength:<número entero> | Duración de la actividad. |
| TimeUnit:Month|Day|Hour|Minute | Unidad de medida de la duración. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Establece la duración de la actividad especificada.
Ejemplos
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:6 -TimeUnit:Day
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:1 -TimeUnit:Month
Comando get-index
Uso
bm.exe get-index -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| Activity:<activity name> | El nombre de la actividad. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Enumera todos los índices que se han creado para la actividad especificada.
Ejemplos
bm.exe get-index -Activity:PurchaseOrder
bm.exe get-index -Activity:PurchaseOrder -Server:Ship -Database:ShipDatabase
Comando create-index
Uso
bm.exe create-index -IndexName:<index name> -Activity:<activity name> -Checkpoint:<checkpoint1>[,<checkpoint2>...] [ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| IndexName:<nombre de índice> | Nombre del índice nuevo. |
| Activity:<activity name> | Nombre de la actividad para la que se crea el índice. |
| Checkpoint:<checkpoint1>[,<checkpoint2>...] | Lista delimitada por comas de puntos de control para el índice. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Crea un índice para la actividad especificada mediante los puntos de control especificados.
Ejemplos
bm.exe create-index -IndexName:Idx1 -Activity:PO -Checkpoint:State,City
bm.exe create-index -IndexName:Idx2 -Activity:PO -Checkpoint:Amount -Server:S1
Comando delete-index
Uso
bm.exe delete-index -IndexName:nombre> de< índice -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parámetros
| Parámetro | Descripción |
|---|---|
| IndexName:<nombre de índice> | Nombre del índice que se va a eliminar. |
| Activity:<activity name> | Nombre de la actividad para la que se elimina el índice. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Elimina el índice especificado con el nombre dado de la actividad especificada.
Ejemplos
bm.exe delete-index -IndexName:Idx1 -Activity:PO
bm.exe delete-index -IndexName:Idx2 -Activity:PO -Server:S1 -Database:BamPI1
Comando get-archive
Uso
bm.exe get-archive -Activity:<activity> [-Server:<server>] [-Database:<database>]
Parámetros
| Parámetro | Descripción |
|---|---|
| Activity:<activity name> | Nombre de la actividad para la que se debe mostrar el comportamiento. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Obtiene el comportamiento del paquete de archivo para la actividad especificada, independientemente de si el paquete archiva datos de actividad o los depura.
Ejemplos
bm.exe get-archive -Activity:PurchaseOrder
Comando set-archive
Uso
bm.exe set-archive -Activity:<activity> -ShouldArchive:True [-Server:<server>] [-Database:<database>]
Parámetros
| Parámetro | Descripción |
|---|---|
| Activity:<activity name> | Nombre de la actividad para la que se debe mostrar el comportamiento. |
| ShouldArchive: True | Si se define como True, la actividad se traslada a la base de datos de archivo. Si se define como False, la actividad se purga. |
| Server:<server> | Opcional: nombre del servidor en el que reside la actividad. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. Si no se especifica el nombre de servidor, bm.exe utiliza el nombre predeterminado de localhost. |
| Database:<database> | Opcional: el nombre de la base de datos en la que reside la actividad. Si no se especifica el nombre, bm.exe usa el nombre predeterminado BamPrimaryImport. |
Define el comportamiento del paquete de archivo para la actividad especificada para que los datos de actividad se trasladen a la base de datos de archivo. De forma predeterminada, se define este comportamiento para las actividades nuevas que se implementan.
Ejemplos
Para purgar los datos de actividad BAM, ejecute lo siguiente:
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:False
Para trasladar los datos de actividad BAM a la base de datos de archivo BAM, ejecute lo siguiente:
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:True