Compartir a través de


Comando ImportBindings

Importa enlaces de un archivo de enlace basado en XML en una aplicación o grupo de BizTalk. Los enlaces se pueden haber exportado desde un ensamblado, una aplicación o un grupo, como se describe en Exportar enlaces. En función de la ubicación desde la que se exportaron los enlaces, los parámetros ApplicationName y GroupLevel tienen efectos diferentes. Para obtener más información, vea la sección "Comentarios" más adelante en este tema.

Nota:

Los archivos de enlace generados en BizTalk Server no tienen una aplicación especificada. Se importan en la aplicación predeterminada.

Uso

BTSTask ImportBindings -Source:value [-GroupLevel-ApplicationName | :value] [-Server:value] [-Database:value] [-ImportTrackingSettings:value] [-ExcludeParties]

Parámetros

Parámetro Obligatorio Importancia
-Source (o -So, vea Comentarios) Obligatorio Ruta de acceso completa del archivo de enlace que se va a importar, incluido el nombre de archivo. Las rutas de acceso que incluyen espacios deben incluirse entre comillas (").
-GroupLevel (o -G, vea comentarios) Opcional Opción para importar el archivo de enlace en el grupo actual. Si especifica este parámetro, no especifique /ApplicationName.
-ApplicationName (o -A, vea Comentarios) Opcional Nombre de la aplicación de BizTalk en la que se van a importar los enlaces. Si el nombre incluye espacios, debe incluirlo entre comillas dobles ("). La aplicación debe existir o se producirá un error en la operación de importación. Si no se especifica este parámetro, se usa la aplicación predeterminada de BizTalk. Si especifica este parámetro, no especifique /GroupLevel.
-Server (o -Se, vea Comentarios) Opcional Nombre de la instancia de SQL Server que hospeda la base de datos de administración de BizTalk, en el formulario NombreDeServidor\NombreDeInstancia,Puerto.

El nombre de instancia solo es necesario cuando el nombre de instancia es diferente del nombre del servidor. El puerto solo es necesario cuando SQL Server usa un número de puerto distinto del predeterminado (1433).

Ejemplos:

Server=MyServer

Server=MyServer\MySQLServer,1533

Si no se proporciona, se usa el nombre de la instancia de SQL Server que se ejecuta en el equipo local.
-Database (o -D, ver comentarios) Opcional Nombre de la base de datos de administración de BizTalk. Si no se especifica, se usa la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server.
-ImportTrackingSettings Opcional Nuevo a partir de BizTalk Server 2016.

Esto invalida la opción de importación de la configuración de seguimiento global. Un valor "true" permite importar la configuración de seguimiento. False no permite la importación de la configuración de seguimiento.
-ExcludeParties Opcional Nuevo a partir de BizTalk Server 2016.

Si se especifica, excluye la información de las partes del archivo de enlace.

Ejemplo

El siguiente comando importa enlaces a la aplicación denominada MyApplication en el grupo de BizTalk predeterminado.

BTSTask ImportBindings -ApplicationName:MyApplication -Source:C:\Bindings\Binding1.xml

El siguiente comando importa enlaces al grupo definido en la base de datos de administración de BizTalk que se ejecuta en una instancia de SQL Server denominada MY_Server.

BTSTask ImportBindings -GroupLevel -Server:MY_Server -Database:BiztalkMgmtDb -Source:C:\Bindings\Binding1.xml

Observaciones

Los parámetros no distinguen mayúsculas de minúsculas. No es necesario escribir el nombre completo del parámetro para especificarlo; Puede escribir las primeras letras del nombre del parámetro que lo identifican de forma inequívoca.

Es posible que los enlaces se hayan exportado desde un ensamblado, una aplicación o un grupo. Dependiendo de dónde se exportaron los enlaces, los parámetros ApplicationName y GroupLevel tienen efectos diferentes, como se muestra en la tabla siguiente.

Origen de los enlaces Efecto con el parámetro ApplicationName Efecto con el parámetro GroupLevel
Enlaces exportados desde un ensamblado La aplicación especificada en ApplicationName debe contener un ensamblado que tenga el mismo nombre que el ensamblado desde el que se exportó el archivo de enlace. De lo contrario, se produce un error en la operación de importación. El grupo actual debe contener un ensamblado y una aplicación que tenga el mismo nombre que el ensamblado y la aplicación desde los que se exportó el archivo de enlace. De lo contrario, se produce un error en la importación.
Enlaces exportados desde una aplicación La aplicación desde la que se exportó el archivo de enlace debe tener el mismo nombre que la aplicación especificada por ApplicationName. De lo contrario, se produce un error en la operación de importación. La aplicación desde la que se exportó el archivo de enlace debe tener el mismo nombre que una aplicación del grupo en el que va a importar los enlaces. De lo contrario, se produce un error en la operación de importación.
Enlaces exportados desde un grupo El grupo desde el que se exportó el archivo de enlace debe incluir una aplicación que tenga el mismo nombre que la aplicación especificada por ApplicationName. De lo contrario, se produce un error en la operación de importación. Los enlaces se importan para las aplicaciones correspondientes. Es decir, los enlaces de una aplicación del grupo desde el que se exportaron los enlaces se importan a una aplicación que tiene el mismo nombre en el grupo actual.

Véase también

Referencia de BTSTask Command-Line
Cómo importar enlaces en un grupo de BizTalk
Cómo importar enlaces en una aplicación de BizTalk