Comando AddResource: assembly .NET
Per aggiungere un assembly .NET (che include componenti COM o COM+ gestiti) a un'applicazione BizTalk, usare il comando AddResource e specificare System.BizTalk:Assembly 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, nella cartella Risorse dell'applicazione a cui è stato aggiunto. Inoltre, l'assembly viene elencato quando si usa il comando ListApp.
Se un assembly ha lo stesso nome completo di un assembly già esistente nell'applicazione, è possibile specificare il parametro Overwrite. Il nome completo è costituito dal nome, dal token di chiave pubblica, dalla lingua e dalla versione. In questo caso, l'assembly esistente viene sovrascritto. Per altre informazioni sulle dipendenze, vedere Dipendenze e distribuzione di applicazioni.
Utilizzo
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly[/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/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 predefinita BizTalk per il gruppo. |
| /Type (o /T, vedere Osservazioni) | Sì | System.BizTalk:Assembly (questo valore non fa 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 include il nome dell'assembly, la versione, la lingua e il token di chiave pubblica. Queste informazioni vengono visualizzate nel campo Nome della cartella Risorse dell'applicazione nella Console di amministrazione BizTalk Server. |
| /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 ("). Se si specifica l'opzione RegasmOnInstall o RegsvcsOnInstall, è necessario specificare anche Destination. Nota: È possibile utilizzare la variabile di ambiente %BTAD_InstallDir% per specificare la cartella di installazione dell'applicazione. In questo modo nei vari computer di destinazione viene creata una posizione analoga per i file dell'applicazione. Esempio: "%BTAD_InstallDir%\MyAssemblies\Orchestrations.dll" |
| /Options (o /Op, vedere Osservazioni) | No | - GacOnAdd: installare l'assembly nella Global Assembly Cache (GAC) nel computer locale durante l'operazione AddResource. - GacOnInstall: installare l'assembly nella GAC quando l'applicazione viene installata dal file .msi. - GacOnImport: installare l'assembly nella GAC quando l'applicazione .msi file viene importato. - RegasmOnInstall: aggiungere un assembly COM gestito al Registro di sistema di Windows quando l'applicazione viene installata dal file .msi. Se si specifica questa opzione, è necessario specificare anche Destination. - RegsvcsOnInstall:Aggiungere un assembly COM+ gestito al Registro di sistema di Windows quando l'applicazione viene installata dal file .msi. Se si specifica questa opzione, è necessario specificare anche Destination. È necessario separare più opzioni con una virgola. Tra le virgole e i valori non devono esserci spazi. |
| /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, viene utilizzato il nome del database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server. |
Esempio
BTSTask AddResource /ApplicationName:MyApplication /Type: System.BizTalk:Assembly /Overwrite /Source:"%BTAD_InstallDir%\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /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 .NET a un'applicazione