Comando RemoveApp
Consente di rimuovere (eliminare) dal database di gestione BizTalk un'applicazione BizTalk e tutti gli elementi in essa contenuti. L'applicazione non viene disinstallata. Per istruzioni su questa operazione, vedere Come disinstallare un'applicazione BizTalk.
L'operazione di rimozione non riesce nei seguenti casi:
L'applicazione non è stata arrestata. Per istruzioni sull'arresto di un'applicazione, vedere Come avviare e arrestare un'applicazione BizTalk. L'esempio di ApplicationManager SDK installato nella <directory Samples Path>\Amministrazione\ExplorerOM\ illustra come avviare o arrestare un'applicazione BizTalk Server a livello di codice.
Altre applicazioni contengono riferimenti all'applicazione. Se altre applicazioni contengono riferimenti all'applicazione da rimuovere, è necessario rimuovere prima i riferimenti dalle altre applicazioni. Per istruzioni, vedere Come rimuovere un riferimento a un'altra applicazione.
L'applicazione contiene un gruppo di porte di trasmissione a cui appartiene una porta di trasmissione in un'altra applicazione. Per poter eliminare l'applicazione è necessario prima rimuovere la porta di trasmissione come membro. Per istruzioni, vedere Come annullare l'elenco di una porta di trasmissione o di un gruppo di porte di trasmissione.
L'applicazione contiene una porta di trasmissione a cui fa riferimento un'entità. È possibile eliminare il riferimento dall'entità o spostare la porta di trasmissione in un'altra applicazione. Per istruzioni sull'esecuzione di queste attività, vedere Visualizzare o modificare un'entità o Come spostare un elemento in un'applicazione diversa.
L'applicazione è l'applicazione predefinita. Per eliminarla, è necessario prima impostare come predefinita un'altra applicazione. Per istruzioni, vedere Come modificare l'applicazione predefinita.
Un'orchestrazione nell'applicazione è integrata, avviata o con un'istanza in sospeso. Per altre informazioni sulle orchestrazioni, vedere Gestione delle orchestrazioni.
Nota
Se l'applicazione contiene un criterio che si trova in uno stato distribuito, il criterio non viene rimosso dal database del motore regole e continua a essere visualizzato nella cartella Criteri nel <nodo dell'applicazione Tutti gli> artefatti della console di amministrazione BizTalk. Se si aggiunge il criterio a un'altra applicazione, lo stato del criterio rimane Distribuito.
Utilizzo
BTSTask RemoveApp /ApplicationName:value [/Server:value] [/Database:value]
Parametri
| Parametro | Obbligatoria | Descrizione |
|---|---|---|
| /ApplicationName (o /A, vedere Osservazioni) | Sì | Nome dell'applicazione BizTalk da eliminare. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). |
| /Server (o /S, vedere Osservazioni) | No | Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk, nel formato NomeServer\NomeIstanza,Porta. È necessario specificare il nome dell'istanza solo se è diverso dal nome del server. È necessario specificare la porta solo se SQL Server utilizza un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non si specifica il nome dell'istanza, viene utilizzato il nome dell'istanza di SQL Server in esecuzione nel computer locale. |
| /Database (o /D, vedere Osservazioni) | No | Nome del database di gestione BizTalk. Se omesso, verrà utilizzato il nome del database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server. |
Esempio
BTSTask RemoveApp /ApplicationName:MyApplication
Commenti
Per i nomi di parametro non è rilevante la distinzione tra maiuscole e minuscole. Per specificare il parametro, non è necessario digitare l'intero nome. È sufficiente digitare le prime lettere del nome per identificare il parametro in modo non ambiguo.
Vedere anche
Informazioni di riferimento sulla riga di comando BTSTask
Annullamento della distribuzione di applicazioni BizTalk