Comandi di gestione dell'infrastruttura
I comandi di configurazione dell'utilità di gestione BAM (BM) consentono di recuperare e aggiornare la configurazione BAM.
get-config: ottiene il file di configurazione BAM.
update-config: Aggiornamenti la configurazione BAM.
get-changes: elenca le modifiche apportate all'infrastruttura BAM.
get-defxml: ottiene un file contenente tutti gli artefatti nel database di importazione primaria BAM.
Nota
È possibile abilitare la traccia in qualsiasi comando di utilità BM includendo l'opzione -Trace:on|off . 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 BM comune.
Nota
In un sistema che supporta il controllo dell'account utente, potrebbe essere necessario eseguire lo strumento con i privilegi amministrativi.
Comando get-config
Utilizzo
bm.exe get-config -FileName:<output file> [ -Server:server> ][ -Database:<database<> ]
Parametri
| Parametro | Descrizione |
|---|---|
| FileName:<output file> | Percorso e nome del file in cui salvare il file di configurazione. |
| Server:<server> | Facoltativo: nome del server da cui ottenere la configurazione. 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 la configurazione. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Recupera il codice XML della configurazione BAM e lo salva nel file specificato. Il comando get-config non sovrascriverà il file esistente.
esempi
bm.exe get-config -FileName:MyConfig.xml
bm.exe get-config -FileName:BAMConfiguration.xml -Server:OrdersServer
Comando update-config
Utilizzo
bm.exe update-config -FileName:<config file>
Parametri
| Parametro | Descrizione |
|---|---|
| FileName:<config file> | Il percorso e il nome del file di configurazione da cui aggiornare l'infrastruttura BAM. |
Aggiorna la configurazione nel computer locale da un file che contiene il codice XML della configurazione BAM. È possibile aggiungere nomi di server e database che non esistono nella configurazione corrente. Non è possibile modificare i nomi di server o di database per cui è già stata distribuita l'infrastruttura dinamica. Eventuali tentativi causeranno la segnalazione di un errore da parte di bm.exe.
Se si modifica l'indirizzo di destinazione del file per gli avvisi recapitati in base al file, sarà necessario riavviare il servizio SQL Notification Services. Se tale servizio non viene riavviato, gli avvisi continueranno a essere recapitati all'indirizzo di destinazione del file originale.
Per cambiare l'indirizzo di destinazione, è necessario modificare la seguente riga del file di configurazione BAM.
<Nome proprietà="FileDropUNC">\\<nome> computer\alert</Property>
Per i passaggi appropriati per aggiornare i riferimenti, vedere Backup e ripristino BizTalk Server.
Importante
Se si esegue un comando update-database utilizzando un file di configurazione BAM che non contiene una sezione per gli avvisi e sono già stati configurati gli avvisi BAM, bm.exe sovrascriverà la configurazione e gli avvisi non funzioneranno più.
esempi
bm.exe update-config -FileName:MyConfig.xml
Comando get-changes
Utilizzo
bm.exe get-changes [ -Server:server ][ -Database:<<database> ]>
Parametri
| Parametro | Descrizione |
|---|---|
| Server:<server> | Facoltativo: nome del server in cui risiede il database di importazione primaria BAM. 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: se il nome non è specificato, bm.exe usa il nome predefinito BamPrimaryImport. |
Ottiene un elenco delle modifiche applicate al database di importazione primaria BAM. È possibile utilizzare questo comando per controllare le modifiche all'infrastruttura BAM. Il comando restituisce le seguenti informazioni:
Tipo di comando della modifica e file da cui è stata applicata la modifica.
Chi ha applicato la modifica.
Quali attività sono state modificate.
Quali visualizzazioni sono state modificate.
esempi
bm.exe get-changes
Output del comando
#1: Distribuire c:\bam\ordermanagement.xml
By domain\user at 12/30/2005 8:17:08 PM (v3.5.1536.0).
Attività: OrderMgmt
Visualizzazioni: SalesManager
Comando get-defxml
Utilizzo
bm.exe get-defxml -FileName:<output file>[ -Server:server> ][ -Database:<database<> ]
Parametri
| Parametro | Descrizione |
|---|---|
| FileName:<output file> | Percorso e nome del file in cui salvare le definizioni. |
| Server:<server> | Facoltativo: nome del server da cui ottenere le definizioni. 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 le definizioni. se non si specifica il nome, bm.exe utilizza il nome predefinito BamPrimaryImport. |
Recupera tutti gli elementi dal database di importazione primaria BAM e li salva in un file XML. I file esistenti non verranno sovrascritti.
esempi
bm.exe get-defxml -FileName:BAMDefinition.xml
bm.exe get-defxml -FileName:MyDef.xml -Server:MyServer -Database:MyPI