Comando ImportApp

Importa gli artefatti contenuti in un file .msi in un'applicazione BizTalk. Se l'applicazione non esiste già, viene creata.

Quando si importa un'applicazione, è possibile usare il parametro /Environment per specificare l'ambiente di distribuzione di destinazione per l'applicazione, se sono stati aggiunti file di associazione a questa applicazione personalizzati per un ambiente di distribuzione specifico. 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.

Annotazioni

Un'operazione di importazione raggiunge il timeout se supera i 3600 secondi di durata. Se si tenta di importare un file .msi e si verifica il timeout dell'operazione, è necessario dividere il contenuto dell'applicazione in più di un file .msi esportando nuovamente l'applicazione e selezionando un subset di artefatti da esportare. Per altre informazioni, vedere Come esportare un'applicazione BizTalk.

Se l'importazione non riesce, BTSTask restituisce il numero di errori. La maggior parte delle azioni eseguite durante l'operazione viene eseguito il rollback, ad eccezione dei seguenti:

• Non viene eseguito il rollback delle azioni eseguite da script personalizzati. È possibile scrivere gli script in modo da eseguire il rollback usando la variabile di ambiente Elimina.

• Se gli assembly sono stati installati nella Global Assembly Cache (GAC), non vengono rimossi.

• Le voci eseguite nel Registro di sistema di Windows non vengono rimosse.

  Se l'importazione ha esito positivo, BTSTask restituisce "0".

Utilizzo

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

Parametri

Parametro	Obbligatorio	Valore
/Package (o /P, vedere Osservazioni)	Sì	Percorso completo del file .msi. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie ("). Esempio: "C:\My MSI Files\MyApplication.msi"
/Environment (o /E, vedere Osservazioni)	No	Ambiente di distribuzione di destinazione del file di associazione da applicare, ad esempio Test. Si tratta del valore specificato per l'ambiente di distribuzione di destinazione quando il file di associazione è stato aggiunto all'applicazione. Se non specificato, vengono applicate tutte le associazioni che non dispongono di un ambiente specificato.
/ApplicationName (o /A, vedere Osservazioni)	No	Nome dell'applicazione BizTalk in cui vengono importati gli artefatti nel file .msi. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). Se non specificato, viene usata l'applicazione predefinita. Se l'applicazione specificata non esiste, viene creata l'applicazione.
/Overwrite (o /O, vedere Osservazioni)	No	Opzione per sovrascrivere gli artefatti nell'applicazione con artefatti nel file .msi con lo stesso identificatore univoco locale (LUID). È possibile visualizzare gli identificatori LUID degli artefatti in un'applicazione usando il comando ListApp. Se questa opzione non è specificata e nell'applicazione sono presenti uno o più artefatti con lo stesso LUID degli elementi nel file .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. Il nome dell'istanza è obbligatorio solo quando il nome dell'istanza è diverso dal nome del server. La porta è necessaria solo quando SQL Server usa un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non specificato, viene usato 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 non specificato, viene usato il 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

Osservazioni:

I parametri non fanno distinzione tra maiuscole e minuscole. Non è necessario digitare l'intero nome del parametro per specificarlo; è possibile digitare le prime lettere del nome del parametro che lo identificano senza ambiguità.

Vedere anche

Informazioni di riferimento su BTSTask Command-Line
Come importare un'applicazione BizTalk