Comando ImportBindings
Consente di importare i binding da un file di associazione basato su XML in un'applicazione o in un gruppo BizTalk. Le associazioni potrebbero essere state esportate da un assembly, da un'applicazione o da un gruppo, come descritto in Esportazione di associazioni. A seconda della posizione da cui i binding sono stati esportati, cambiano gli effetti dei parametri ApplicationName e GroupLevel. Per ulteriori informazioni, vedere la sezione "Note" più avanti in questo argomento.
Nota
I file di associazione generati in BizTalk Server non hanno un'applicazione specificata. Vengono importati nell'applicazione predefinita.
Utilizzo
BTSTask ImportBindings -Source:value [-GroupLevel-ApplicationName | :value] [-Server:value] [-Database:value] [-ImportTrackingSettings:value] [-ExcludeParties]
Parametri
| Parametro | Obbligatoria | valore |
|---|---|---|
| -Source (o -So, vedere Osservazioni) | Necessario | Percorso completo del file di associazione da importare, incluso il nome del file. I percorsi contenenti spazi devono essere racchiusi tra virgolette ("). |
| -GroupLevel (o -G, vedere Osservazioni) | Facoltativo | Opzione che consente di importare il file di associazione nel gruppo corrente. Se si specifica questo parametro, evitare di specificare /ApplicationName. |
| -ApplicationName (o -A, vedere Osservazioni) | Facoltativo | Nome dell'applicazione BizTalk in cui vengono importate i binding. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). L'applicazione deve esistere, altrimenti l'operazione di importazione ha esito negativo. Se questo parametro viene omesso, verrà utilizzata l'applicazione BizTalk predefinita. Se si specifica questo parametro, evitare di specificare /GroupLevel. |
| -Server (o -Se, vedere Osservazioni) | Facoltativo | 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) | Facoltativo | 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. |
| -ImportTrackingSettings | Facoltativo | Novità a partire da BizTalk Server 2016. Questa opzione esegue l'override dell'opzione di importazione dell'impostazione di rilevamento globale. Un valore "true" consente l'importazione delle impostazioni di rilevamento. False non consente l'importazione dell'impostazione di rilevamento. |
| -ExcludeParties | Facoltativo | Novità a partire da BizTalk Server 2016. Se specificato, esclude le informazioni delle parti dal file di associazione. |
Esempio
Il seguente comando consente di importare binding nell'applicazione denominata MyApplication nel gruppo BizTalk predefinito.
BTSTask ImportBindings -ApplicationName:MyApplication -Source:C:\Bindings\Binding1.xml
Il seguente comando consente di importare binding nel gruppo definito nel database di gestione BizTalk in esecuzione in un'istanza di SQL Server denominata MY_Server.
BTSTask ImportBindings -GroupLevel -Server:MY_Server -Database:BiztalkMgmtDb -Source:C:\Bindings\Binding1.xml
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.
I binding possono essere stati esportati da un assembly, un'applicazione o un gruppo. A seconda della posizione da cui i binding sono stati esportati, cambiano gli effetti dei parametri ApplicationName e GroupLevel, come illustrato nella seguente tabella.
| Origine dei binding | Effetto con il parametro ApplicationName | Effetto con il parametro GroupLevel |
|---|---|---|
| Binding esportati da un assembly | L'applicazione specificata in ApplicationName deve contenere un assembly che ha lo stesso nome dell'assembly da cui è stato esportato il file di associazione. In caso contrario, l'operazione di importazione avrà esito negativo. | Il gruppo corrente deve contenere un assembly e un'applicazione con lo stesso nome dell'assembly e dell'applicazione da cui è stato esportato il file di associazione. In caso contrario, l'importazione avrà esito negativo. |
| Binding esportati da un'applicazione | L'applicazione da cui il file di associazione è stato esportato deve avere lo stesso nome dell'applicazione specificata da ApplicationName. In caso contrario, l'operazione di importazione avrà esito negativo. | L'applicazione da cui è stato esportato il file di associazione deve avere lo stesso nome di un'applicazione inclusa nel gruppo in cui vengono importati i binding. In caso contrario, l'operazione di importazione avrà esito negativo. |
| Binding esportati da un gruppo | Il gruppo da cui il file di associazione è stato esportato deve includere un'applicazione con lo stesso nome dell'applicazione specificata da ApplicationName. In caso contrario, l'operazione di importazione avrà esito negativo. | Vengono importati i binding per le applicazioni corrispondenti. In altre parole, i binding di un'applicazione del gruppo da cui sono stati esportati i binding vengono importati in un'applicazione che ha lo stesso nome nel gruppo corrente. |
Vedere anche
Informazioni di riferimento sulla riga di comando BTSTask
Come importare binding in un gruppo BizTalk
Come importare binding in un'applicazione BizTalk