Cómo agregar un directorio virtual a una aplicación

En este tema se describe cómo usar la herramienta de línea de comandos BTSTask para agregar un directorio virtual a una aplicación de BizTalk. Esta opción no está disponible en la consola de administración de BizTalk Server. Puede que desee agregar un directorio virtual si ha escrito un servicio Web personalizado o si ha creado un sitio Web ASP.NET para interactuar con BizTalk Server y desea implementar el directorio virtual con la aplicación.

Otra manera de agregar un directorio virtual a una aplicación es especificando un directorio virtual para una ubicación de recepción SOAP o HTTP, como se describe en How to Configure an HTTP Receive Location. En todos los casos, el directorio virtual se agrega a la base de datos de administración de BizTalk. Al agregar un directorio virtual mediante la línea de comandos, también se muestra en la consola de administración de BizTalk Server, en la carpeta Resources de la aplicación a la que lo agregó, así como la lista de artefactos de la aplicación cuando se usa el comando ListApp. Si posteriormente exporta la aplicación y, a continuación, la importa en otro grupo de BizTalk, el directorio virtual se muestra en la carpeta Recursos.

Al agregar un directorio virtual a una aplicación, tenga en cuenta los siguientes puntos:

• Puede sobrescribir un directorio virtual que exista ya en la aplicación, especificando la opción de sobrescritura. La opción de sobrescritura solo es necesaria cuando el directorio virtual existente tiene el mismo nombre que el que desea agregar. Si no se especifica y ya existe un directorio virtual en la aplicación con el mismo nombre que el que se va a agregar, se producirá un error en la operación de adición.

• Al agregar un directorio virtual con una dirección URL que contiene https, debe utilizar http en lugar de https en la dirección URL que especifica. Si utiliza https, se producirá un error en la operación de agregación de un directorio virtual. Aunque lo agregue con http en la dirección URL, la configuración https para la dirección URL en la metabase de Internet Information Services tendrá efecto y el directorio virtual funcionará correctamente.

• Si agrega un directorio virtual desde una versión de 64 bits del servicio Web e intenta instalar la aplicación que incluye el directorio virtual en un equipo de 32 bits, no se instalará el directorio virtual. Debe estar instalado en un equipo de 64 bits.

Importante

Al importar una aplicación que contiene un directorio virtual, la configuración de seguridad del directorio virtual es la que está activa cuando el archivo .msi se genera durante la exportación de la aplicación. Si implementa una aplicación en un entorno de producción, antes de exportar la aplicación debería comprobar que la configuración satisface los requisitos de seguridad.

Si, en cambio, el directorio virtual ya existe en el entorno de destino, estará activa la configuración de seguridad del directorio virtual existente. No se modifica para que coincida con la del directorio virtual que va a implementar. En este caso, debería comprobar que la configuración de seguridad del directorio virtual existente cumple con los requisitos que desea.

Precaución

Si el directorio virtual usa el protocolo HTTPS (Protocolo de transferencia de hipertexto a través de capa de sockets seguros), la configuración de seguridad no se mantiene durante la exportación y cuando se importa, el directorio virtual heredará la configuración de seguridad del elemento raíz. Debería comprobar que la configuración de seguridad cumple con los requisitos.

Requisitos previos

Para realizar el procedimiento descrito en este tema, deberá iniciar sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.

Para agregar un directorio virtual a una aplicación

1. Abra un símbolo del sistema como se indica a continuación: haga clic en Inicio, haga clic en Ejecutar, escriba cmdy, a continuación, haga clic en Aceptar.

2. Escriba el siguiente comando, sustituyendo los valores según corresponda, como se describe en la tabla que se presenta a continuación:

   BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:WebDirectory[/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value]

   Ejemplo:

   BTSTask AddResource /ApplicationName:MyApplication /Type: System.BizTalk:WebDirectory /Overwrite /Source: /Destination:http://Host1:90/MyVirtualDirectoryhttp://Host2:90/MyVirtualDirectory /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parámetro	Value
   /Applicationname	Nombre de la aplicación de BizTalk a la que se agrega el directorio virtual. Si no se especifica el nombre de aplicación, se utiliza la aplicación predeterminada de BizTalk para el grupo. Si el nombre incluye espacios, debe incluirlo entre comillas dobles (").
   /Tipo	System.BizTalk:WebDirectory (este valor no distingue mayúsculas de minúsculas).
   /Sobrescribir	Opción para actualizar un directorio virtual existente. Si no se especifica y ya existe un directorio virtual en la aplicación que tiene el mismo nombre que el directorio virtual que se agrega, se produce un error en la operación AddResources.
   /Fuente	URI del directorio virtual de origen.
   /Destino	URI que se va a asignar al directorio virtual cuando se desinstale la aplicación del archivo .msi. Si no se especifica este parámetro, se utiliza el valor del parámetro Source teniendo localhost como host.
   /Servidor	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.
   /Base	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.

Consulte también

Administración de ensamblados .NET, certificados y otros recursos
AddResource (comando): Directorio virtual
Creación y modificación de aplicaciones de BizTalk