AddResource (comando): Enlace de BizTalk
Para agregar un archivo de enlace a una aplicación de BizTalk, use el comando AddResource y especifique System.BizTalk:BizTalkBinding para el parámetro Type . Cuando agrega un archivo de enlace, puede especificar un entorno de implementación para él. Cuando importa posteriormente la aplicación, puede seleccionar este entorno de implementación para aplicar los enlaces. Puede agregar cualquier número de archivos de enlace a una aplicación de BizTalk, cada uno personalizado para un entorno de implementación diferente. Para agregar varios archivos de enlace, ejecute este comando para cada archivo que desee agregar.
Puede agregar un archivo de enlace que exportó para un ensamblado, una aplicación o un grupo, como se describe en ExportBindings Command y, a continuación, usar el comando AddResource para agregar el archivo de enlace a una aplicación.
Ejecutar este comando agrega el archivo de enlace a la base de datos de administración de BizTalk y el archivo se muestra en la carpeta Recursos de la aplicación. Además, el archivo aparece cuando se usa el comando ListApp. A diferencia de lo que ocurre al importar un archivo de enlace, agregar un archivo de enlace no cambia inmediatamente los enlaces existentes. Los enlaces no se aplican hasta que la aplicación se importe a otro grupo de BizTalk.
Cuando agrega un archivo de enlace, puede especificar el entorno de implementación mediante el parámetro opcional "TargetEnvironment" /Property. El valor puede ser cualquier cadena que represente el entorno de implementación en el que desea aplicar los enlaces en este archivo, como Prueba o Producción. Si no especifica un valor para el parámetro /Property, se especifica automáticamente un valor de <Default> y este archivo de enlace se aplicará cada vez que se importe la aplicación.
Cuando importa una aplicación que incluye uno o varios archivos de enlace que ha agregado explícitamente de esta forma, puede seleccionar los archivos de enlace que se van a aplicar al especificar el valor del parámetro /Property. Los enlaces se aplican en la importación de la aplicación.
A medida que se aplican los enlaces durante el proceso de importación, los enlaces que ya se han aplicado se sobrescriben con enlaces nuevos que tienen el mismo nombre. Es decir, surtirá efecto el último enlace de un nombre concreto que se aplica. Téngalo en cuenta cuando utilice varios archivos de enlace. Si contienen entradas duplicadas, tendrá efecto el último enlace aplicado. Cuando importa una aplicación, los enlaces se aplican en el orden siguiente:
Los enlaces de la aplicación generados por BizTalk Server que no se agregaron explícitamente a la aplicación mediante un archivo de enlace, pero que el usuario seleccionó explícitamente para exportarlos al archivo .msi de la aplicación.
Los archivos de enlace que se han agregado explícitamente y que no tienen especificado un entorno de implementación de destino. Los enlaces de este conjunto no se aplican en ningún orden específico.
Los enlaces que se ha agregado explícitamente y que tienen un entorno de implementación de destino asociado que coincide con el entorno de implementación seleccionado para la importación de la aplicación. Los enlaces de este conjunto no se aplican en ningún orden específico.
Para obtener más información, vea Cómo importar una aplicación de BizTalk. Para obtener información general sobre el uso de archivos de enlace, vea Binding Files and Application Deployment.
Uso
BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding/Property:TargetEnvironment="value" [/Overwrite] /Source:value [/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 archivo de enlace. 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:BizTalkBinding (este valor no distingue mayúsculas de minúsculas). |
| /Source (o /So, vea comentarios) | Sí | Ruta completa del archivo de enlace, incluido el nombre de archivo. Si la ruta incluye espacios, la debe encerrar entre comillas dobles ("). |
| /Property:TargetEnvironment= (o /P:TargetEnvironment=, vea Comentarios) | No | Cadena que especifica el entorno de implementación de destino. Puede utilizar cualquier cadena, por ejemplo Producción. Ejemplo: /Property:TargetEnvironment="Production" Si no se especifica, se aplica automáticamente un valor de <Default> . El valor distingue mayúsculas de minúsculas. Si el valor incluye espacios, lo debe encerrar entre comillas dobles ("). La longitud máxima del valor del entorno es 128 caracteres. |
| /Overwrite (o /Ov, vea Comentarios) | No | Opción para actualizar un archivo de enlace existente. Si no se especifica y ya existe un archivo de enlace en la aplicación que tiene el mismo nombre de archivo que el archivo que se agrega, se produce un error en la operación AddResource. |
| /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:BizTalkBinding /Property:TargetEnvironment=Test /Source:"C:\Binding Files\MyBinding.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
Comentarios
Los nombres de propiedad distinguen entre mayúsculas y minúsculas. 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 archivo de enlace a una aplicación