Come aggiungere una directory virtuale a un'applicazione

In questo argomento viene descritto come utilizzare lo strumento da riga di comando BTSTask per aggiungere una directory virtuale a un'applicazione BizTalk. Questa opzione non è disponibile nella console di amministrazione BizTalk Server Potrebbe essere utile aggiungere una directory virtuale se si è scritto un servizio Web personalizzato o si è creato un sito Web ASP.NET per l'interfaccia con BizTalk Server e si desidera distribuire la directory virtuale con l'applicazione.

Un altro modo per aggiungere una directory virtuale a un'applicazione consiste nel specificare una directory virtuale per un percorso di ricezione SOAP o HTTP, come descritto in Come configurare un percorso di ricezione HTTP. In ogni caso la directory virtuale verrà aggiunta al database di gestione BizTalk. Quando si aggiunge una directory virtuale usando 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 elementi nell'applicazione quando si usa il comando ListApp. Se in seguito si esporta l'applicazione e quindi la si importa in un altro gruppo di BizTalk, la directory virtuale sarà visualizzata nella cartella Risorse.

Quando si aggiunge una directory virtuale a un'applicazione, tenere presenti le considerazioni seguenti:

• È possibile sovrascrivere una directory virtuale già esistente nell'applicazione specificando l'opzione per la sovrascrittura. L'opzione di sovrascrittura è necessaria solo quando la directory virtuale esistente ha lo stesso nome di quello che si desidera 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 che contiene https, è necessario utilizzare http nell'URL specificato, anziché https. Se si utilizza https, l'operazione di aggiunta della directory virtuale avrà esito negativo. Anche se si specifica http nell'URL, l'impostazione https dell'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 installata nei computer a 64 bit.

Importante

Quando si importa un'applicazione contenente una directory virtuale, le impostazioni di sicurezza riguardanti la directory virtuale corrispondono a quelle attivate quando il file con estensione msi viene generato durante l'esportazione dell'applicazione. Se si sta distribuendo un'applicazione in un ambiente di produzione, prima di esportare l'applicazione è necessario verificare che le impostazioni soddisfino i requisiti di sicurezza desiderati.

Tuttavia, se la directory virtuale è già esistente nell'ambiente di destinazione, le impostazioni di sicurezza riguardanti la directory virtuale esistente resteranno attive e non verranno modificate per corrispondere a quelle riguardanti la directory virtuale che si sta distribuendo. In questo caso è consigliabile verificare che le impostazioni di sicurezza riguardanti la directory virtuale esistente soddisfino i requisiti di sicurezza desiderati.

Attenzione

Se la directory virtuale utilizza il protocollo HTTPS (Hypertext Transfer Protocol over Secure Socket Layer), le relative impostazioni di sicurezza non vengono mantenute durante l'esportazione e, al momento dell'importazione, la directory virtuale erediterà le impostazioni di sicurezza della radice. È quindi consigliabile verificare che le impostazioni di sicurezza soddisfino i requisiti desiderati.

Prerequisiti

Per eseguire la procedura descritta in questo argomento, è necessario effettuare l'accesso con un account membro del gruppo Amministratori BizTalk Server. 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 che segue:

   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: /Destination:http://Host1:90/MyVirtualDirectoryhttp://Host2:90/MyVirtualDirectory /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parametro	Valore
   /Applicationname	Nome dell'applicazione BizTalk a cui aggiungere la directory virtuale. Se non si specifica il nome dell'applicazione, viene utilizzata l'applicazione predefinita BizTalk per il gruppo. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Digitare	System.BizTalk:WebDirectory (questo valore non fa distinzione tra maiuscole e minuscole).
   /Sovrascrivere	Opzione per aggiornare una directory virtuale esistente. Se si omette, 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 durante l'installazione dell'applicazione dal file con estensione msi. Se si omette questo parametro, viene utilizzato il valore del parametro Source localhost come host.
   /Server	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	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.

Vedere anche

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