AddResource (comando): Ensamblado de BizTalk
Para agregar un ensamblado de BizTalk a una aplicación de BizTalk, use el comando AddResource y especifique System.BizTalk:BizTalkAssembly para el parámetro Type. Ejecutar este comando agrega el ensamblado a la base de datos de administración de BizTalk. El ensamblado también se muestra en la consola de administración de BizTalk Server, en la carpeta Recursos de la aplicación a la que agregó. Los artefactos incluidos en el ensamblado también se muestran en las carpetas correspondientes. Además, los artefactos se enumeran cuando se usa el comando ListApp.
Cuando utilice este comando, tenga en cuenta los puntos siguientes:
Si un ensamblado tiene el mismo nombre completo que un ensamblado ya existente en la aplicación, debe especificar el parámetro Overwrite ya que de no ser así, se producirá un error en la operación AddResource. El nombre completo consta del nombre, del token de clave pública, de la referencia cultural y de la versión. Sin embargo, si otra aplicación depende de este ensamblado, se producirá un error en la operación AddResource aunque especifique el parámetro Overwrite.
Si existe otro ensamblado que tiene el mismo nombre completo en el grupo, se producirá un error en la operación AddResource aunque especifique el parámetro Overwrite.
Si está sobrescribiendo un ensamblado que contiene orquestaciones, las orquestaciones se deben detener y dar de baja antes de ejecutar este comando. Asimismo, se deben detener y dar de baja los puertos de envío a los que está enlazada la orquestación y se deben deshabilitar las ubicaciones de recepción.
Si el ensamblado que está agregando tiene una dependencia en otro artefacto que no está incluido en la aplicación, se producirá un error en la operación AddResource.
Para obtener más información sobre las dependencias, consulte Dependencias e implementación de aplicaciones.
Uso
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/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. |
| /Type (o /T, vea Comentarios) | Sí | System.BizTalk:BizTalkAssembly (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 corresponde con el identificador local único (LUID) para el ensamblado. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp. Sin embargo, si otra aplicación depende del ensamblado que se está sobrescribiendo, se producirá un error en la operación AddResource aunque se especifique este parámetro. |
| /Source (o /So, vea Comentarios) | Sí | Ruta de acceso completa del archivo de ensamblado, incluido el nombre de archivo. Si la ruta incluye espacios, la 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, la debe encerrar entre comillas dobles ("). Nota: Puede usar la variable de entorno %BTAD_InstallDir%, que se establece durante BizTalk Server instalación, para especificar la carpeta de instalación de la aplicación. Esto creará una ubicación coherente para los archivos de la aplicación en equipos de destino diferentes. Ejemplo: "%BTAD_InstallDir%\MyFiles\Orchestrations.dll" |
| /Options (o /Op, vea Comentarios) | No | - GacOnAdd: especifique para instalar el ensamblado en la caché global de ensamblados (GAC) en el equipo local durante la operación AddResource. - GacOnInstall: especifique para instalar el ensamblado en la GAC cuando la aplicación se instala desde el archivo .msi. - GacOnImport: especifique para instalar el ensamblado en la GAC cuando se importe la aplicación .msi archivo. Debe separar varias opciones mediante una coma. |
| /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 especifica, 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:BizTalkAssembly /Overwrite
/Source:"%BTAD_InstallDir%\Source Assemblies\Orchestrations.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\Orchestrations.dll" /Options:GacOnInstall,GacOnImport /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 de BizTalk a una aplicación