Comando AddResource: associazione BizTalk
Per aggiungere un file di associazione a un'applicazione BizTalk, usare il comando AddResource e specificare System.BizTalk:BizTalkBinding per il parametro Type . Quando si aggiunge un file di associazione, è possibile specificare un ambiente di distribuzione. Successivamente, quando si importerà l'applicazione, sarà possibile selezionare questo ambiente di distribuzione per applicare i binding. È possibile aggiungere qualsiasi numero di file di associazione a un'applicazione BizTalk, ciascuno personalizzato per un ambiente di distribuzione diverso. Per aggiungere più file di associazione è necessario eseguire questo comando per ogni file.
È possibile aggiungere un file di associazione esportato per un assembly, un'applicazione o un gruppo, come descritto in Comando ExportBindings, quindi usare il comando AddResource per aggiungere il file di associazione a un'applicazione.
Quando si esegue questo comando, il file di associazione viene aggiunto al database di gestione BizTalk e viene visualizzato nella cartella Risorse dell'applicazione. Inoltre, il file viene elencato quando si usa il comando ListApp. Diversamente da quanto avviene nel caso dell'importazione, l'aggiunta di un file di associazione non comporta la modifica immediata dei binding esistenti. I binding non vengono applicati finché l'applicazione non viene importata in un altro gruppo BizTalk.
Quando si aggiunge un file di associazione, è possibile specificare l'ambiente di distribuzione utilizzando il parametro facoltativo /Property:TargetEnvironment. Il valore può essere qualsiasi stringa che rappresenti l'ambiente di distribuzione in cui si desidera applicare i binding inclusi nel file, ad esempio Test o Produzione. Se non si specifica un valore per il parametro /Property, viene specificato automaticamente un valore <Default> e questo file di associazione verrà applicato ogni volta che l'applicazione viene importata.
Quando si importa un'applicazione che include uno o più file di associazione che sono stati aggiunti esplicitamente in questo modo, è possibile selezionare il file o i file di associazione da applicare specificando il valore del parametro /Property. I binding vengono applicati durante l'importazione dell'applicazione.
Durante il processo di importazione, i binding che sono già stati applicati vengono sovrascritti da quelli nuovi con lo stesso nome. In altre parole, ha effetto l'ultimo binding con un determinato nome che è stato applicato. È importante tenere presente questo punto quando si utilizzano più file di associazione. Se contengono voci doppie, avrà effetto l'ultimo binding applicato. Quando si importa un'applicazione, i binding vengono applicati nell'ordine seguente:
Binding di applicazione generati da BizTalk Server che non sono stati aggiunti esplicitamente all'applicazione mediante un file di associazione, ma che sono stati selezionati esplicitamente dall'utente per l'esportazione nel file con estensione msi dell'applicazione.
File di associazione che sono stati aggiunti esplicitamente e per cui non è stato specificato un ambiente di distribuzione di destinazione. I binding di questo gruppo vengono applicati senza un ordine specifico.
I binding che sono stati aggiunti esplicitamente e ai quali è associato un ambiente di distribuzione di destinazione corrispondente all'ambiente di distribuzione selezionato per l'importazione dell'applicazione. I binding di questo gruppo vengono applicati senza un ordine specifico.
Per altre informazioni, vedere Come importare un'applicazione BizTalk. Per informazioni di base sull'uso dei file di associazione, vedere Binding Files and Application Deployment.For background information about using binding files, see Binding Files and Application Deployment.
Utilizzo
BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding/Property:TargetEnvironment="value" [/Overwrite] /Source:value [/Server:value] [/Database:value]
Parametri
| Parametro | Obbligatoria | valore |
|---|---|---|
| /ApplicationName (o /A, vedere Osservazioni) | No | Nome dell'applicazione BizTalk a cui aggiungere il file di associazione. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). Se non si specifica il nome dell'applicazione, viene utilizzata l'applicazione BizTalk predefinita. |
| /Type (o /T, vedere Osservazioni) | Sì | System.BizTalk:BizTalkBinding (questo valore non fa distinzione tra maiuscole e minuscole). |
| /Source (o /So, vedere Osservazioni) | Sì | Percorso completo del file di associazione, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie ("). |
| /Property:TargetEnvironment= (o /P:TargetEnvironment=, vedere Osservazioni) | No | Stringa che specifica l'ambiente di distribuzione di destinazione. È possibile utilizzare qualsiasi stringa, ad esempio Produzione. Esempio: /Property:TargetEnvironment="Production" Se non specificato, viene applicato automaticamente un valore Default<>. Per il valore viene fatta distinzione tra maiuscole e minuscole. Se il valore include spazi, è necessario racchiuderlo tra virgolette doppie ("). La lunghezza massima del valore dell'ambiente è di 128 caratteri. |
| /Overwrite (o /Ov, vedere Osservazioni) | No | Opzione per aggiornare un file di associazione esistente. Se omesso, e nell'applicazione esiste un file di associazione con lo stesso nome del file da aggiungere, l'operazione AddResource ha esito negativo. |
| /Server (o /Se, 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 /Da, vedere Osservazioni) | No | Nome del database di gestione BizTalk. Se omesso, viene utilizzato il nome del database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server. |
Esempio
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkBinding /Property:TargetEnvironment=Test /Source:"C:\Binding Files\MyBinding.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
Commenti
I nomi delle proprietà distinguono tra maiuscole e minuscole. 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
Comando AddResource
Come aggiungere un file di associazione a un'applicazione
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per