AddResource (comando): ensamblado de .NET
Para agregar un ensamblado de .NET (que incluye componentes COM o COM+ administrados) a una aplicación de BizTalk, use el comando AddResource y especifique System.BizTalk:Assembly para el parámetro Type. Ejecutar este comando agrega el ensamblado a la base de datos de administración de BizTalk. Además, el ensamblado aparece en la consola de administración de BizTalk Server en la carpeta Recursos de la aplicación a la que lo agregó. Además, el ensamblado aparece cuando se usa el comando ListApp.
Si un ensamblado tiene el mismo nombre completo que un ensamblado ya existente en la aplicación, puede especificar el parámetro Overwrite. El nombre completo consta del nombre, del token de clave pública, de la referencia cultural y de la versión. En este caso, se sobrescribe el ensamblado existente. Para obtener más información sobre las dependencias, consulte Dependencias e implementación de aplicaciones.
Uso
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly[/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]
Parámetros
| Parámetro | Obligatorio | Value |
|---|---|---|
| /ApplicationName (o /A, vea Comentarios) | No | Nombre de la aplicación de BizTalk a la que se agrega el ensamblado. Si el nombre incluye espacios, debe incluirlo entre comillas dobles ("). Si no se especifica el nombre de aplicación, se utiliza la aplicación predeterminada de BizTalk para el grupo. |
| /Type (o /T, vea Comentarios) | Sí | System.BizTalk:Assembly (este valor no distingue mayúsculas de minúsculas). |
| /Overwrite (o /Ov, vea Comentarios) | No | Opción para actualizar un ensamblado existente. Si no se especifica y ya existe un ensamblado en la aplicación que tiene el mismo nombre completo que el ensamblado que se agrega, se produce un error en la operación AddResource. El nombre completo consta del nombre de ensamblado, de la versión, de la referencia cultural y del token de clave pública. Esta información se muestra en el campo Nombre de la carpeta Recursos de la aplicación dentro de la consola de administración de BizTalk Server. |
| /Source (o /So, vea comentarios) | Sí | Ruta de acceso completa del archivo de ensamblado, incluido el nombre de archivo. Si la ruta incluye espacios, los debe encerrar entre comillas dobles ("). |
| /Destination (o /De, vea Comentarios) | No | Ruta completa de la ubicación en la que se va a copiar el archivo de ensamblado cuando se instale la aplicación desde el archivo .msi. Si no se proporciona, el archivo de ensamblado no se copia al sistema de archivos local durante instalación. Si la ruta incluye espacios, los debe encerrar entre comillas dobles ("). Si especifica la opción RegasmOnInstall o RegsvcsOnInstall, también debe especificar Destino. Nota: Puede usar la variable de entorno %BTAD_InstallDir% para especificar la carpeta de instalación de la aplicación. Esto crea una ubicación coherente para los archivos de la aplicación en equipos de destino diferentes. Ejemplo: "%BTAD_InstallDir%\MyAssemblies\Orchestrations.dll" |
| /Options (o /Op, vea Comentarios) | No | - GacOnAdd: instale el ensamblado en la caché global de ensamblados (GAC) en el equipo local durante la operación AddResource. - GacOnInstall: instale el ensamblado en la GAC cuando la aplicación se instale desde el archivo .msi. - GacOnImport: instale el ensamblado en la GAC cuando se importe la aplicación .msi archivo. - RegasmOnInstall: agregue un ensamblado COM administrado al Registro de Windows cuando la aplicación se instale desde el archivo .msi. Si especifica esta opción, también debe especificar Destino. - RegsvcsOnInstall:Agregue un ensamblado COM+ administrado al registro de Windows cuando la aplicación se instale desde el archivo .msi. Si especifica esta opción, también debe especificar Destino. Debe separar varias opciones mediante una coma. No puede haber espacios entre comas y valores. |
| /Server (o /Se, vea comentarios) | No | Nombre del servidor SQL Server que aloja la base de datos de administración de BizTalk en el formato Nombredelservidor\Nombredeinstancia,Puerto. Sólo se necesita el nombre de instancia cuando el nombre de instancia es diferente del nombre de servidor. Sólo se necesita el puerto cuando el servidor SQL Server utiliza un nombre de puerto diferente al predeterminado (1433) Ejemplos: Servidor = MyServer Servidor = MyServer\MySQLServer,1533 Si no se proporciona, se utiliza el nombre de la instancia de SQL Server que se ejecuta en el equipo local. |
| /Database (o /Da, vea comentarios) | No | Nombre de la base de datos de administración de BizTalk. Si no se proporciona, se utiliza la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server. |
Muestra
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
Comentarios
Los parámetros no distinguen mayúsculas de minúsculas. No es necesario escribir el nombre de todo el parámetro para especificarlo; puede escribir las primeras letras del nombre de parámetro que lo identifican sin ambigüedad.
Consulte también
AddResource (comando)
Cómo agregar un ensamblado .NET a una aplicación