ImportBindings (comando)

Importa enlaces desde un archivo de enlace basado en XML a un grupo o a una aplicación 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 a la aplicación predeterminada.

Uso

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

Parámetros

Parámetro	Obligatorio	Value
-Source (o -So, vea comentarios)	Requerido	Ruta completa del archivo de enlace que se va a importar, incluido el nombre de archivo. Si el nombre de las rutas incluye espacios, debe ir entre comillas dobles (").
-GroupLevel (o -G, vea Comentarios)	Opcionales	Opción para importar el archivo de enlace al grupo actual. Si especifica este parámetro, no especifique /ApplicationName.
-ApplicationName (o -A, vea comentarios)	Opcionales	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 utiliza la aplicación de BizTalk predeterminada. Si especifica este parámetro, no especifique /GroupLevel.
-Server (o -Se, vea comentarios)	Opcionales	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 -D, ver comentarios)	Opcionales	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.
-ImportTrackingSettings	Opcionales	Novedades 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 la importación de la configuración de seguimiento. False no permite la importación de la configuración de seguimiento.
-ExcludeParties	Opcionales	Novedades a partir de BizTalk Server 2016. Si se especifica, excluye información de partes del archivo de enlace.

Muestra

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

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

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

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

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.

Los enlaces se pueden haber exportado de un ensamblado, una aplicación o un grupo. En función de la ubicación desde la que 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 de 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 tengan 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 de 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 mediante 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 al que se importan los enlaces. De lo contrario, se produce un error en la operación de importación.
Enlaces exportados de 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 mediante ApplicationName. De lo contrario, se produce un error en la operación de importación.	Los enlaces se importan para las aplicaciones correspondientes. En otras palabras, 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.

Consulte también

Referencia de línea de comandos de BTSTask
Cómo importar enlaces a un grupo de BizTalk
Cómo importar enlaces a una aplicación de BizTalk