Hinzufügen eines virtuellen Verzeichnisses zu einer Anwendung

In diesem Thema wird erläutert, wie Sie einer BizTalk-Anwendung mit dem Befehlszeilenprogramm BTSTask ein virtuelles Verzeichnis hinzufügen. Diese Option ist in der BizTalk Server-Verwaltungskonsole nicht verfügbar. Möglicherweise möchten Sie einem selbst entwickelten Webdienst oder einer selbst erstellten ASP.NET-Website, die als Schnittstelle zu BizTalk Server dient, ein virtuelles Verzeichnis hinzufügen und es mit der Anwendung bereitstellen.

Eine weitere Möglichkeit zum Hinzufügen eines virtuellen Verzeichnisses zu einer Anwendung besteht darin, ein virtuelles Verzeichnis für einen SOAP- oder HTTP-Empfangsspeicherort anzugeben, wie unter Konfigurieren eines HTTP-Empfangsspeicherorts beschrieben. In jedem Fall wird das virtuelle Verzeichnis der BizTalk-Verwaltungsdatenbank hinzugefügt. Wenn Sie ein virtuelles Verzeichnis mithilfe der Befehlszeile hinzufügen, wird es auch in der BizTalk Server-Verwaltungskonsole, im Ordner Ressourcen der Anwendung, der Sie es hinzugefügt haben, sowie in der Liste der Artefakte in der Anwendung angezeigt, wenn Sie den ListApp-Befehl verwenden. Wenn Sie die Anwendung später exportieren und anschließend in eine andere BizTalk-Gruppe importieren, wird das virtuelle Verzeichnis im Ordner Ressourcen angezeigt.

Beachten Sie beim Hinzufügen eines virtuellen Verzeichnisses zu einer Anwendung die folgenden Punkte:

• Sie können ein bereits in der Anwendung vorhandenes virtuelles Verzeichnis überschreiben, indem Sie die Option Überschreiben angeben. Die Option zum Überschreiben ist nur erforderlich, wenn das vorhandene virtuelle Verzeichnis den gleichen Namen wie das verzeichnis hat, das Sie hinzufügen möchten. Wenn nicht angegeben ist und bereits ein virtuelles Verzeichnis in der Anwendung mit demselben Namen wie das hinzugefügte Verzeichnis vorhanden ist, schlägt der Add-Vorgang fehl.

• Wenn Sie ein virtuelles Verzeichnis mit einer URL hinzufügen, die den Ausdruck "https" enthält, müssen Sie in der angegebenen URL anstelle von "https" das Präfix "http" verwenden. Wenn Sie "https" verwenden, schlägt der Vorgang zum Hinzufügen eines virtuellen Verzeichnisses fehl. Obwohl Sie in der URL den Ausdruck "http" verwenden, sind die "https"-Einstellungen für die URL in der Internetinformationsdienste-Metabasis gültig, und das virtuelle Verzeichnis funktioniert ordnungsgemäß.

• Wenn Sie ein virtuelles Verzeichnis aus einer 64-Bit-Version des Webdiensts hinzufügen und dann versuchen, die Anwendung mit dem virtuellen Verzeichnis auf einem 32-Bit-Computer zu installieren, wird das virtuelle Verzeichnis nicht installiert. Es muss auf einem 64-Bit-Computer installiert werden.

Wichtig

Wenn Sie eine Anwendung importieren, die ein virtuelles Verzeichnis enthält, gelten für das virtuelle Verzeichnis die Sicherheitseinstellungen, die beim Generieren der MSI-Datei während des Anwendungsexports wirksam sind. Wenn Sie eine Anwendung in einer Produktionsumgebung bereitstellen, sollten Sie vor dem Exportieren der Anwendung überprüfen, ob die Einstellungen Ihren Sicherheitsanforderungen entsprechen.

Wenn das virtuelle Verzeichnis jedoch bereits in der Zielumgebung vorhanden ist, werden die Sicherheitseinstellungen des vorhandenen virtuellen Verzeichnisses wirksam. Sie werden nicht an die Einstellungen des virtuellen Verzeichnisses angepasst, das Sie bereitstellen. In diesem Fall sollten Sie überprüfen, ob die Einstellungen des vorhandenen virtuellen Verzeichnisses Ihren Sicherheitsanforderungen entsprechen.

Achtung

Wenn das virtuelle Verzeichnis das HTTPS-Protokoll (Hypertext Transfer Protocol over Secure Socket Layer) verwendet, werden dessen Sicherheitseinstellungen während des Exports nicht beibehalten. Beim Import werden die Sicherheitseinstellungen des Stammverzeichnisses an das virtuelle Verzeichnis vererbt. Sie sollten überprüfen, ob die Sicherheitseinstellungen Ihren Anforderungen entsprechen.

Voraussetzungen

Um das Verfahren in diesem Thema auszuführen, müssen Sie mit einem Konto angemeldet sein, das Mitglied der Gruppe BizTalk Server Administratoren ist. Ausführlichere Informationen zu Berechtigungen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung.

So fügen Sie einer Anwendung ein virtuelles Verzeichnis hinzu

1. Öffnen Sie eine Eingabeaufforderung wie folgt: Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie ein cmd, und klicken Sie dann auf OK.

2. Geben Sie den folgenden Befehl ein, und ersetzen Sie dabei die entsprechenden Werte, wie in der folgenden Tabelle beschrieben:

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

   Beispiel:

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

   Parameter	Wert
   /Applicationname	Der Name der BizTalk-Anwendung, der Sie das virtuelle Verzeichnis hinzufügen. Wenn der Anwendungsname nicht angegeben ist, wird die BizTalk-Standardanwendung für die Gruppe verwendet. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
   /Typ	System.BizTalk:WebDirectory (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.)
   /Überschreiben	Option zum Aktualisieren eines vorhandenen virtuellen Verzeichnisses. Wenn diese Option nicht angegeben ist und die Anwendung bereits ein virtuelles Verzeichnis mit demselben Namen wie das hinzuzufügende virtuelle Verzeichnis enthält, schlägt der AddResource-Vorgang fehl.
   /Quelle	URI des virtuellen Quellverzeichnisses.
   /Ziel	Der URI, der dem virtuellen Verzeichnis zugewiesen werden soll, wenn die Anwendung aus der MSI-Datei installiert wird. Wenn dieser Parameter nicht angegeben ist, wird der Parameter "Source" mit "localhost" als Host verwendet.
   /Server	Der Name der SQL Server-Instanz, die als Host für die BizTalk-Verwaltungsdatenbank dient, im Format Servername\Instanzname,Port. Der Instanzname ist nur erforderlich, wenn sich der Instanzname vom Servernamen unterscheidet. Der Port ist nur erforderlich, wenn in SQL Server eine andere Portnummer als der Standardwert 1433 verwendet wird. Beispiele: Server=MyServer Server=MyServer\MySQLServer,1533 Bei fehlender Angabe wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
   /Datenbank	Der Name der BizTalk-Verwaltungsdatenbank. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

Weitere Informationen

Verwalten von .NET-Assemblys, Zertifikaten und anderen Ressourcen
Befehl „AddResource“: Virtuelles Verzeichnis
Erstellen und Bearbeiten von BizTalk-Anwendungen