Comando AddResource: assembly BizTalk
Per aggiungere un assembly BizTalk a un'applicazione BizTalk, usare il comando AddResource e specificare System.BizTalk:BizTalkAssembly per il parametro Type. Quando si esegue questo comando, l'assembly viene aggiunto al database di gestione BizTalk. L'assembly viene visualizzato anche nella Console di amministrazione BizTalk Server, nella cartella Risorse dell'applicazione a cui è stato aggiunto. Gli elementi inclusi nell'assembly vengono visualizzati nelle cartelle appropriate. Inoltre, gli artefatti vengono elencati quando si usa il comando ListApp.
Quando si utilizza questo comando, è importante tenere presente i seguenti punti:
Se un assembly ha lo stesso nome completo di un assembly già esistente nell'applicazione, è necessario specificare il parametro Overwrite. In caso contrario, l'operazione AddResource avrà esito negativo. Il nome completo è costituito dal nome, dal token di chiave pubblica, dalla lingua e dalla versione. Se un'altra applicazione dipende da questo assembly, l'operazione AddResource avrà esito negativo anche se si specifica il parametro Overwrite.
Se nel gruppo esiste un altro assembly con lo stesso nome completo, l'operazione AddResource avrà esito negativo anche se si specifica il parametro Overwrite.
Se si sovrascrive un assembly che contiene orchestrazioni, prima di eseguire il comando è necessario arrestare le orchestrazioni e rimuoverle. È necessario, inoltre, arrestare e rimuovere le porte di trasmissione a cui è associata l'orchestrazione e disattivare gli indirizzi di ricezione.
L'operazione AddResource ha esito negativo anche se l'assembly da aggiungere presenta una dipendenza da un altro elemento non incluso nell'applicazione.
Per altre informazioni sulle dipendenze, vedere Dipendenze e distribuzione di applicazioni.
Utilizzo
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnImport|] [/Server:value] [/Database:value]
Parametri
| Parametro | Obbligatoria | valore |
|---|---|---|
| /ApplicationName (o /A, vedere Osservazioni) | No | Nome dell'applicazione BizTalk a cui aggiungere l'assembly. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). Se non si specifica il nome dell'applicazione, viene utilizzata l'applicazione BizTalk predefinita. |
| /Type (o /T, vedere Osservazioni) | Sì | System.BizTalk:BizTalkAssembly (questo valore non è distinzione tra maiuscole e minuscole). |
| /Overwrite (o /Ov, vedere Osservazioni) | No | Opzione per aggiornare un assembly esistente. Se si omette, e nell'applicazione esiste già un assembly con lo stesso nome completo dell'assembly da aggiungere, l'operazione AddResource ha esito negativo. Il nome completo corrisponde all'identificatore univoco locale dell'assembly. È possibile visualizzare gli ID LUID per gli artefatti in un'applicazione usando il comando ListApp. Se un'altra applicazione dipende dall'assembly che viene sovrascritto, l'operazione AddResource ha esito negativo, anche se si specifica questo parametro. |
| /Source (o /So, vedere Osservazioni) | Sì | Percorso completo del file assembly, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie ("). |
| /Destination (o /De, vedere Osservazioni) | No | Percorso completo della destinazione in cui verrà copiato il file assembly durante l'installazione dell'applicazione dal file con estensione msi. Se omesso, il file assembly non verrà copiato nel file system locale durante l'installazione. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie ("). Nota: È possibile usare la variabile di ambiente %BTAD_InstallDir%, impostata durante l'installazione di BizTalk Server, per specificare la cartella di installazione dell'applicazione. In questo modo nei vari computer di destinazione verrà creata una posizione analoga per i file dell'applicazione. Esempio: "%BTAD_InstallDir%\MyFiles\Orchestrations.dll" |
| /Options (o /Op, vedere Osservazioni) | No | - GacOnAdd: specificare per installare l'assembly nella global assembly cache (GAC) nel computer locale durante l'operazione AddResource. - GacOnInstall: specificare per installare l'assembly nella gaC quando l'applicazione viene installata dal file .msi. - GacOnImport: specificare per installare l'assembly nella gaC quando l'applicazione .msi file viene importato. È necessario separare più opzioni con una virgola. |
| /Server (o /Se, vedere Osservazioni) | No | Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk, nel formato NomeServer\NomeIstanza,Porta. È necessario specificare il nome dell'istanza solo se è diverso dal nome del server. È necessario specificare la porta solo se SQL Server utilizza un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non si specifica il nome dell'istanza, viene utilizzato il nome dell'istanza di SQL Server in esecuzione nel computer locale. |
| /Database (o /Da, vedere Osservazioni) | No | Nome del database di gestione BizTalk. Se omesso, verrà utilizzato il nome del database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server. |
Esempio
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite
/Source:"%BTAD_InstallDir%\Source Assemblies\Orchestrations.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\Orchestrations.dll" /Options:GacOnInstall,GacOnImport /Server:MyDatabaseServer /Database:BizTalkMgmtDb
Commenti
Per i nomi di parametro non è rilevante la distinzione tra maiuscole e minuscole. Per specificare il parametro, non è necessario digitare l'intero nome. È sufficiente digitare le prime lettere del nome per identificare il parametro in modo non ambiguo.
Vedere anche
Comando AddResource
Come aggiungere un assembly BizTalk a un'applicazione