Comando ImportApp

Consente di importare in un'applicazione BizTalk gli elementi contenuti in un file con estensione msi. Se l'applicazione non esiste, verrà creata automaticamente.

Quando si importa un'applicazione, è possibile utilizzare il parametro /Environment per specificare l'ambiente di distribuzione di destinazione per l'applicazione, se all'applicazione sono stati aggiunti file di binding personalizzati per un determinato ambiente di distribuzione. Per informazioni di base, vedere Binding Files and Application Deployment.For background information, see Binding Files and Application Deployment. Per istruzioni sull'aggiunta di file di associazione, vedere Comando AddResource: Associazione BizTalk.

Nota

Se un'operazione di importazione dura più di 3600 secondi, si verifica il timeout. Se si tenta di importare un file con estensione msi e si verifica il timeout, suddividere il contenuto dell'applicazione in più file con estensione msi esportando di nuovo l'applicazione e selezionando un sottoinsieme di elementi da esportare. Per altre informazioni, vedere Come esportare un'applicazione BizTalk.

Se l'importazione ha esito negativo, BTSTask restituisce il numero di errori. Viene eseguito il rollback della maggior parte delle azioni eseguite durante l'operazione, con le seguenti eccezioni:

• Non viene eseguito il rollback delle azioni svolte dagli script personalizzati. Se si desidera che venga eseguito il rollback degli script, scriverli utilizzando la variabile di ambiente Delete.

• Non vengono rimossi gli assembly installati nella cache degli assembly globali (GAC).

• Non vengono rimosse le voci inserite nel Registro di sistema di Windows.

  Se l'importazione riesce, BTSTask restituisce "0".

Utilizzo

BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]

Parametri

Parametro	Obbligatoria	valore
/Package (o /P, vedere Osservazioni)	Sì	Percorso completo del file con estensione msi. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie ("). Esempio: "C:\My MSI Files\MyApplication.msi"
/Environment (o /E, vedere Osservazioni)	No	L'ambiente di distribuzione di destinazione del file di binding da applicare, ad esempio Test. È il valore che è stato specificato per l'ambiente di distribuzione di destinazione quando il file di binding è stato aggiunto all'applicazione. Se omesso, vengono applicati tutti i binding per cui non è stato specificato un ambiente.
/ApplicationName (o /A, vedere Osservazioni)	No	Nome dell'applicazione BizTalk in cui vengono importati gli elementi del file con estensione msi. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). Se omesso, viene utilizzata l'applicazione predefinita. Se l'applicazione specificata non esiste, verrà creata.
/Overwrite (o /O, vedere Osservazioni)	No	Consente di sovrascrivere gli elementi dell'applicazione con gli elementi del file con estensione msi che presentano lo stesso identificatore univoco locale. È possibile visualizzare gli identificatori LUID degli artefatti in un'applicazione usando il comando ListApp. Se questo parametro viene omesso e se vi sono uno o più elementi dell'applicazione che presentano lo stesso identificatore univoco locale di elementi del file con estensione msi, l'importazione ha esito negativo.
/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 ImportApp /Package:C:\MSI\MyApplication.msi /Environment:Test /ApplicationName:MyApplication /Overwrite

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
Come importare un'applicazione BizTalk