Comando ImportBindings

Importa associazioni da un file di associazione basato su XML in un'applicazione o un gruppo BizTalk. Le associazioni possono essere state esportate da un assembly, da un'applicazione o da un gruppo, come descritto in Esportazione di associazioni. A seconda del percorso da cui sono state esportate le associazioni, i parametri ApplicationName e GroupLevel hanno effetti diversi. Per ulteriori informazioni, vedere la sezione "Note" più avanti in questo argomento.

Annotazioni

I file di associazione generati in BizTalk Server non dispongono di 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	Obbligatorio	Valore
-Source (o -So, vedere Osservazioni)	Obbligatorio	Percorso completo del file di associazione da importare, incluso il nome file. I percorsi che includono spazi devono essere racchiusi tra virgolette (").
-GroupLevel (o -G, vedere Osservazioni)	Opzionale	Opzione per importare il file di associazione nel gruppo corrente. Se si specifica questo parametro, non specificare /ApplicationName.
-ApplicationName (o -A, vedere Osservazioni)	Opzionale	Nome dell'applicazione BizTalk in cui importare le associazioni. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie ("). L'applicazione deve esistere oppure l'operazione di importazione avrà esito negativo. Se questo parametro non viene specificato, viene usata l'applicazione BizTalk predefinita. Se si specifica questo parametro, non specificare /GroupLevel.
-Server (o -Se, vedere Osservazioni)	Opzionale	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)	Opzionale	Nome del database di gestione BizTalk. Se non specificato, viene usato il database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.
-ImportTrackingSettings	Opzionale	Novità a partire da BizTalk Server 2016. Questa opzione sostituisce l'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	Opzionale	Novità a partire da BizTalk Server 2016. Se specificato, esclude le informazioni sulle parti dal file di associazione.

Esempio

Il comando seguente importa le associazioni nell'applicazione denominata MyApplication nel gruppo BizTalk predefinito.

BTSTask ImportBindings -ApplicationName:MyApplication -Source:C:\Bindings\Binding1.xml

Il comando seguente importa le associazioni 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

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à.

È possibile che le associazioni siano state esportate da un assembly, un'applicazione o un gruppo. A seconda della posizione in cui sono state esportate le associazioni, i parametri ApplicationName e GroupLevel hanno effetti diversi, come illustrato nella tabella seguente.

Origine delle associazioni	Effetto con il parametro ApplicationName	Effetto con il parametro GroupLevel
Associazioni esportate da un assembly	L'applicazione specificata in ApplicationName deve contenere un assembly con lo stesso nome dell'assembly da cui è stato esportato il file di associazione. In caso contrario, l'operazione di importazione non riesce.	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 non riesce.
Associazioni esportate da un'applicazione	L'applicazione da cui è stato esportato il file di associazione deve avere lo stesso nome dell'applicazione specificata da ApplicationName. In caso contrario, l'operazione di importazione non riesce.	L'applicazione da cui è stato esportato il file di associazione deve avere lo stesso nome di un'applicazione nel gruppo in cui si stanno importando le associazioni. In caso contrario, l'operazione di importazione non riesce.
Associazioni esportate da un gruppo	Il gruppo da cui è stato esportato il file di associazione deve includere un'applicazione con lo stesso nome dell'applicazione specificata da ApplicationName. In caso contrario, l'operazione di importazione non riesce.	Le associazioni vengono importate per le applicazioni corrispondenti. In altre parole, le associazioni di un'applicazione nel gruppo da cui le associazioni sono state esportate vengono importate in un'applicazione con lo stesso nome nel gruppo corrente.

Vedere anche

Informazioni di riferimento su BTSTask Command-Line
Come importare i binding in un gruppo di BizTalk
Come importare le configurazioni di binding in un'applicazione BizTalk