Come aggiungere una directory virtuale a un'applicazione

Questo argomento descrive come usare lo strumento da riga di comando BTSTask per aggiungere una directory virtuale a un'applicazione BizTalk. Questa opzione non è disponibile nella console di amministrazione di BizTalk Server. Potrebbe essere necessario aggiungere una directory virtuale se è stato scritto un servizio Web personalizzato o è stato creato un sito Web ASP.NET per interfacciarsi con BizTalk Server e si vuole distribuire la directory virtuale con l'applicazione.

Un altro modo per aggiungere una directory virtuale a un'applicazione consiste nello specificare una directory virtuale per un percorso di ricezione SOAP o HTTP, come descritto in Come configurare un percorso di ricezione HTTP. In tutti i casi, la directory virtuale viene aggiunta al database di gestione BizTalk. Quando si aggiunge una directory virtuale tramite la riga di comando, viene visualizzata anche nella console di amministrazione di BizTalk Server, nella cartella Risorse dell'applicazione a cui è stata aggiunta, nonché nell'elenco di artefatti nell'applicazione quando si usa il comando ListApp. Se in un secondo momento si esporta l'applicazione e la si importa in un altro gruppo BizTalk, la directory virtuale viene visualizzata nella cartella Risorse.

Quando si aggiunge una directory virtuale a un'applicazione, tenere presente quanto segue:

• È possibile sovrascrivere una directory virtuale già esistente nell'applicazione specificando l'opzione di sovrascrittura. L'opzione di sovrascrittura è necessaria solo quando la directory virtuale esistente ha lo stesso nome di quello che si vuole aggiungere. Se non specificato e nell'applicazione esiste già una directory virtuale con lo stesso nome di quello aggiunto, l'operazione di aggiunta avrà esito negativo.

• Quando si aggiunge una directory virtuale con un URL contenente https, è necessario usare http nell'URL specificato anziché https. Se si usa https, l'operazione per aggiungere una directory virtuale avrà esito negativo. Anche se lo si aggiunge con http nell'URL, l'impostazione https per l'URL nella metabase di Internet Information Services sarà attiva e la directory virtuale funzionerà correttamente.

• Se si aggiunge una directory virtuale da una versione a 64 bit del servizio Web e si tenta di installare l'applicazione che include la directory virtuale in un computer a 32 bit, la directory virtuale non verrà installata. Deve essere installato in un computer a 64 bit.

Importante

Quando si importa un'applicazione contenente una directory virtuale, le impostazioni di sicurezza nella directory virtuale sono quelle effettive quando il file .msi viene generato durante l'esportazione dell'applicazione. Se si distribuisce un'applicazione in un ambiente di produzione, prima di esportare l'applicazione, è necessario verificare che le impostazioni soddisfino i requisiti di sicurezza.

Se, tuttavia, la directory virtuale esiste già nell'ambiente di destinazione, le impostazioni di sicurezza nella directory virtuale esistente saranno effettive. Non vengono modificati per corrispondere a quelli della directory virtuale che viene distribuita. In questo caso, è necessario verificare che le impostazioni di sicurezza nella directory virtuale esistente soddisfino i requisiti.

Attenzione

Se la directory virtuale usa il protocollo HTTPS (Hypertext Transfer Protocol over Secure Socket Layer), le impostazioni di sicurezza non vengono mantenute durante l'esportazione e, quando viene importata, la directory virtuale erediterà le impostazioni di sicurezza della radice. È necessario verificare che le impostazioni di sicurezza soddisfino i requisiti.

Prerequisiti

Per eseguire la procedura descritta in questo argomento, è necessario essere connessi con un account membro del gruppo BizTalk Server Administrators. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Per aggiungere una directory virtuale a un'applicazione

1. Aprire un prompt dei comandi come indicato di seguito: fare clic su Start, fare clic su Esegui, digitare cmde quindi fare clic su OK.

2. Digitare il comando seguente, sostituendo i valori appropriati, come descritto nella tabella seguente:

   BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:WebDirectory[/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value]

   Esempio:

   BTSTask AddResource /ApplicationName:MyApplication /Type: System.BizTalk:WebDirectory /Overwrite /Source:http://Host1:90/MyVirtualDirectory /Destination:http://Host2:90/MyVirtualDirectory /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parametro	Valore
   /ApplicationName	Nome dell'applicazione BizTalk a cui aggiungere la directory virtuale. Se il nome dell'applicazione non viene specificato, viene usata l'applicazione BizTalk predefinita per il gruppo. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Tipo	System.BizTalk:WebDirectory (questo valore non fa distinzione tra maiuscole e minuscole).
   /Sovrascrivere	Opzione per aggiornare una directory virtuale esistente. Se non specificato e nell'applicazione esiste già una directory virtuale con lo stesso nome della directory virtuale da aggiungere, l'operazione AddResources ha esito negativo.
   /Fonte	URI della directory virtuale di origine.
   /Destinazione	URI da assegnare alla directory virtuale quando l'applicazione viene installata dal file .msi. Se questo parametro non viene specificato, il valore del parametro Source viene usato con localhost come host.
   /Server	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.
   /Banca dati	Nome del database di gestione BizTalk. Se non specificato, viene usato il database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.

Vedere anche

Gestione di assembly, certificati e altre risorse .NET
Comando AddResource: Directory virtuale
Creazione e modifica di applicazioni BizTalk