How to Delete a BizTalk Application from the BizTalk Group

You can delete an application from the BizTalk group. This removes all of its data from the BizTalk databases for the group, and the application no longer displays in the BizTalk Server Administration console. It does not uninstall the application.

Before you delete an application, bear in mind the following points:

• The application must be stopped before you can delete it. You should use the Full Stop option for stopping the application, as described in How to Start and Stop a BizTalk Application.

• You can delete an application only if no other applications contain references to it. If other applications contain references to the application you want to remove, you must first remove the references from the other applications. For instructions, see How to Remove a Reference to Another Application.

• You cannot delete an application if it contains a send port group of which a send port in another application is a member. You must unenlist the member send port before you can delete the application. For instructions, see How to Unenlist a Send Port or Send Port Group.

• You cannot delete an application if it contains a send port that is referenced by a party. You can delete the reference from the party, delete the send port, or move the send port to a different application. For instructions on performing these tasks, see View or Edit a Party, How to Delete a Send Port, or How to Move an Artifact to a Different Application.

• You cannot delete the default application. If you want to delete it, you must first make another application the default. For instructions, see How to Change the Default Application.

• You cannot delete an application if an orchestration in the application has a suspended instance.

• To completely undeploy a BizTalk application, you must also take the steps described in How to Uninstall a BizTalk Application, and you may also need to remove other files and settings, as described in How to Remove Other Files and Settings for a BizTalk Application.

Prerequisites

To perform the procedures in this topic, you must be logged on with an account that is a member of the BizTalk Server Administrators group. For more detailed information on permissions, see Permissions Required for Deploying and Managing a BizTalk Application.

Delete a BizTalk app using BizTalk Server Administration

1. Click Start, click All Programs, click Microsoft BizTalk Server 20xx, and then click BizTalk Server Administration.

2. In the console tree, expand BizTalk Server Administration, expand the BizTalk group, and expand Applications.

3. Right-click the application folder, and then click Delete.

4. Click Yes to confirm the deletion.

   BizTalk Server deletes all of the application data from the BizTalk databases and removes the application from the administration console.

   If BizTalk Server cannot delete any of the application artifacts, the delete operation fails. In this case, BizTalk Server attempts to roll back the delete operation.

Delete a BizTalk app using the command line

1. Open a command prompt as follows: Click Start, click Run, type cmd, and then click OK.

2. Type the following command, substituting the appropriate values, as described in the following table:

   BTSTask RemoveApp /ApplicationName: value [/Server:value] [/Database:value]

   Example:

   BTSTask RemoveApp /ApplicationName:MyApplication

   Parameter	Value
   /ApplicationName	Name of the BizTalk application to delete. If the name includes spaces, you must enclose it in double quotation marks (").
   /Server	Name of the SQL Server instance hosting the BizTalk Management database. Required if you specify the Database parameter. If Server and Database parameters are not specified, the default BizTalk Management database for the group is used.
   /Database	Name of the BizTalk Management database. Required if you specify the Server parameter. If Server and Database parameters are not specified, the default BizTalk Management database for the group is used.

See Also

Undeploying BizTalk Applications
Deploying BizTalk Applications