Commande RemoveApp

Supprime d'une base de données de gestion BizTalk une application BizTalk ou tous les artefacts que cette base de données contient. Cela ne désinstalle pas l’application. Pour obtenir des instructions sur cette opération, consultez Comment désinstaller une application BizTalk.

L'opération de suppression échoue dans les cas suivants :

• L'application n'est pas arrêtée. Pour obtenir des instructions sur l’arrêt d’une application, consultez Guide pratique pour démarrer et arrêter une application BizTalk. L’exemple de kit de développement logiciel (SDK) ApplicationManager installé dans le <répertoire Samples Path>\Administration\ExplorerOM\ montre comment démarrer ou arrêter par programmation une application BizTalk Server.

• D'autres applications contiennent des références à cette application. Si d'autres applications contiennent des références à l'application que vous souhaitez supprimer, vous devez d'abord supprimer les références dans les autres applications. Pour obtenir des instructions, consultez Comment supprimer une référence à une autre application.

• L'application contient un groupe de ports d'envoi dont un port d'envoi d'une autre application est membre. Dans ce cas, vous devez désinscrire le port d'envoi membre avant de supprimer l'application. Pour obtenir des instructions, consultez Comment annuler la liste d’un port d’envoi ou d’un groupe de ports d’envoi.

• L'application contient un port d'envoi référencé par un tiers. Vous pouvez supprimer la référence du tiers ou placer le port d'envoi dans une application différente. Pour obtenir des instructions sur l’exécution de ces tâches, consultez Afficher ou modifier une partie ou Comment déplacer un artefact vers une autre application.

• L'application concernée est l'application par défaut. Si vous souhaitez la supprimer, vous devez d'abord définir une autre application en tant qu'application par défaut. Pour obtenir des instructions, consultez Comment modifier l’application par défaut.

• Une orchestration de l'application est inscrite, a été démarrée ou comprend une instance dont l'exécution est interrompue. Pour plus d’informations sur les orchestrations, consultez Gestion des orchestrations.

Notes

Si l’application contient une stratégie qui est dans un état déployé, la stratégie n’est pas supprimée de la base de données moteur de règles et continue à s’afficher dans le dossier Stratégies sous le <nœud d’application Tous les artefacts> de la console Administration BizTalk. Si vous ajoutez la stratégie à une autre application, elle reste à l'état déployé.

Utilisation

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

Paramètres

Paramètre	Obligatoire	Description
/ApplicationName (ou /A, voir Remarques)	Yes	Nom de l'application BizTalk à supprimer. Si le nom comprend des espaces, vous devez l’entourer de guillemets doubles (« ).
/Server (ou /S, voir Remarques)	No	Nom de l'instance SQL Server hébergeant la base de données de gestion BizTalk et indiqué sous la forme NomServeur\NomInstance,Port. Le nom de l'instance est uniquement requis lorsqu'il est différent du nom du serveur. Le port est uniquement requis lorsque le serveur SQL Server utilise un numéro de port autre que celui par défaut (1433). Exemples : Server=MyServer Server=MyServer\MySQLServer,1533 Si vous n'indiquez pas de nom pour l'instance SQL Server, le nom d'instance utilisé est celui de l'instance SQL Server exécutée sur l'ordinateur local.
/Database (ou /D, voir Remarques)	No	Nom de la base de données de gestion BizTalk. Si vous ne l'indiquez pas, la base de données utilisée est la base de données de gestion BizTalk s'exécutant au sein de l'instance locale de SQL Server.

Exemple

BTSTask RemoveApp /ApplicationName:MyApplication

Remarques

Les paramètres ne respectent pas la casse. Il n'est pas nécessaire de taper le nom complet du paramètre pour l'indiquer. Vous pouvez vous contenter de taper les premières lettres du nom à condition qu'elles suffisent à identifier le paramètre sans ambiguïté.

Voir aussi

Référence de la ligne de commande BTSTask
Annulation du déploiement des applications BizTalk