Comandi per la gestione delle attività
I comandi per la gestione delle attività dell'utilità di gestione BAM consentono di lavorare con le attività distribuite.
get-activities: ottiene un elenco di attività distribuite.
remove-activity: rimuove un'attività.
get-activitywindow: ottiene la durata di un'attività.
set-activitywindow: imposta la durata dell'attività per un'attività.
get-index: ottiene l'elenco degli indici.
create-index: crea un nuovo indice.
delete-index: elimina un indice.
get-archive: ottiene il comportamento dell'attività archiviata.
set-archive: imposta il comportamento dell'attività archiviata.
Nota
È possibile abilitare la traccia in qualsiasi comando dell'utilità BAM includendo l'opzione -Trace:on|off parametro. Tramite l'opzione Trace viene eseguito l'override delle impostazioni di traccia nel file di configurazione. Questa opzione può essere utilizzata in combinazione con qualsiasi comando BAM comune.
Nota
In un sistema che supporta il controllo dell'account utente, potrebbe essere necessario eseguire lo strumento con i privilegi amministrativi.
Comando get-activities
Utilizzo
bm.exe get-activities [ -View:<view name> ][ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| Nome:<nome attività> | Nome dell'attività da rimuovere. |
| Server:<server> | Facoltativo: nome del server da cui ottenere l'elenco delle attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database da cui ottenere l'elenco delle attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di visualizzare un elenco delle attività distribuite nel computer in cui viene eseguito il comando.
esempi
bm.exe get-activities -View:SalesManagerView
bm.exe get-activities -Server:MyServer -Database:MyPrimaryImport
Comando remove-activity
Utilizzo
bm.exe remove-activity -Name:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| Nome:<nome attività> | Nome dell'attività da rimuovere. |
| Server:<server> | Facoltativo: nome del server da cui rimuovere l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database da cui rimuovere l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di rimuovere l'attività specificata dal database di importazione primaria BAM. Se per l'attività esistono visualizzazioni dipendenti, il comando non verrà eseguito e verrà segnalato un errore. Utilizzare il comando remove-view per rimuovere tutte le visualizzazioni dipendenti ed eseguire di nuovo il comando remove-activity.
esempi
bm.exe remove-activity -Name:PurchaseOrder
bm.exe remove-activity -Name:PO -Server:MyServer -Database:MyPrimaryImport
Comando get-activitywindow
Utilizzo
bm.exe get-activitywindow -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| Activity:<activity name> | Nome dell'attività. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di visualizzare la durata per l'attività specificata. Il comando restituisce la durata e le unità in base alle quali viene misurata.
esempi
bm.exe get-activitywindow -Activity:PurchaseOrder
bm.exe get-activitywindow -Activity:PO -Server:Ship -Database:ShipDatabase
Comando set-activitywindow
Utilizzo
bm.exe set-activitywindow -Activity:<activity name> -TimeLength:<integer number> -TimeUnit:Month|Giorno|Ora |Minute[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| Activity:<activity name> | Nome dell'attività. |
| TimeLength:<integer number> | Durata per l'attività. |
| TimeUnit:Month|Day|Hour|Minute | Misura unitaria per la durata. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di impostare la durata per l'attività specificata.
esempi
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:6 -TimeUnit:Day
bm.exe set-activitywindow -Activity:PurchaseOrder -TimeLength:1 -TimeUnit:Month
Comando get-index
Utilizzo
bm.exe get-index -Activity:<activity name>[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| Activity:<activity name> | Nome dell'attività. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di visualizzare un elenco di tutti gli indici che sono stati creati per l'attività specificata.
esempi
bm.exe get-index -Activity:PurchaseOrder
bm.exe get-index -Activity:PurchaseOrder -Server:Ship -Database:ShipDatabase
Comando create-index
Utilizzo
bm.exe create-index -IndexName:<index name -Activity:<activity name>> -Checkpoint1<>[,<checkpoint2>...] [ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| IndexName:<index name> | Nome del nuovo indice. |
| Activity:<activity name> | Nome dell'attività per cui è stato creato l'indice. |
| Checkpoint:<checkpoint1>[,<checkpoint2>...] | Elenco delimitato da virgola dei punti di arresto per l'indice. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di creare un indice per l'attività specificata utilizzando i punti di arresto specificati.
esempi
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
Utilizzo
bm.exe delete-index -IndexName:<index name -Activity:<activity name>>[ -Server:<server> ][ -Database:<database> ]
Parametri
| Parametro | Descrizione |
|---|---|
| IndexName:<index name> | Nome dell'indice da eliminare. |
| Activity:<activity name> | Nome dell'attività per cui eliminare l'indice. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di eliminare l'indice specificato con il nome dato dall'attività specificata.
esempi
bm.exe delete-index -IndexName:Idx1 -Activity:PO
bm.exe delete-index -IndexName:Idx2 -Activity:PO -Server:S1 -Database:BamPI1
Comando get-archive
Utilizzo
bm.exe get-archive -Activity:<activity> [-Server:<server>] [-Database:<database>]
Parametri
| Parametro | Descrizione |
|---|---|
| Activity:<activity name> | Nome dell'attività per cui deve essere visualizzato il comportamento. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di ottenere il comportamento del pacchetto di archiviazione per l'attività specificata, ovvero se tale pacchetto archivierà o eliminerà i dati relativi all'attività.
esempi
bm.exe get-archive -Activity:PurchaseOrder
Comando set-archive
Utilizzo
bm.exe set-archive -Activity:<activity> -ShouldArchive:True [-Server:<server>] [-Database:<database>]
Parametri
| Parametro | Descrizione |
|---|---|
| Activity:<activity name> | Nome dell'attività per cui deve essere visualizzato il comportamento. |
| ShouldArchive: True | Se True, l'attività viene spostata nel database di archiviazione. Se False, l'attività viene eliminata. |
| Server:<server> | Facoltativo: nome del server in cui risiede l'attività. Il server deve appartenere allo stesso dominio del computer da cui si esegue bm.exe. Se non si specifica il nome di server, bm.exe utilizza il nome predefinito di localhost. |
| Database:<database> | Facoltativo: nome del database in cui risiede l'attività. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Consente di impostare il comportamento del pacchetto di archiviazione per l'attività specificata, in modo che i dati relativi all'attività vengano spostati nel database di archiviazione. Per impostazione predefinita, questo comportamento è impostato per le nuove attività distribuite.
esempi
Per eliminare i dati dell'attività BAM, eseguire quanto segue:
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:False
Per spostare i dati dell'attività BAM nel database BAMArchive, eseguire quanto segue:
bm.exe set-archive -Activity:PurchaseOrder -ShouldArchive:True