Freigeben über

Anwendung für eine Site <Anwendung>

  • Artikel

Übersicht

Das Element <application> steuert die Konfigurationseinstellungen für eine bestimmte Anwendung. Eine Anwendung in Internetinformationsdienste (IIS) 7 oder höher ist eine Gruppierung von Dateien, die Inhalte liefert oder Dienste über Protokolle bereitstellt, z. B. HTTP. Wenn Sie eine Anwendung in IIS 7 und höher erstellen, wird der Pfad der Anwendung Teil der Site-URL.

In IIS 7 und höher muss jeder Standort über mindestens eine Anwendung verfügen, die als Stamm- oder Standardanwendung bezeichnet wird. Eine Site kann jedoch über mehr als eine Anwendung verfügen. Ihre Website für Online-Handel kann zum Beispiel über mehrere Anwendungen verfügen, z. B. eine Anwendung für einen Einkaufswagen, mit der Benutzer während des Einkaufs Artikel sammeln können und eine Anwendung für die Anmeldung, mit der Benutzer gespeicherte Zahlungsinformationen abrufen können, wenn sie einen Kauf tätigen.

Eine Anwendung muss mindestens ein virtuelles Verzeichnis enthalten, das als Stamm- oder Standard-virtuelles Verzeichnis mit Konfigurationseinstellungen bezeichnet wird, die in einem <virtualDirectory>-Element definiert sind.

Kompatibilität

Version Hinweise
IIS 10.0 Das <application> Element wurde in IIS 10.0 nicht geändert.
IIS 8.5 Das <application> Element wurde in IIS 8.5 nicht geändert.
IIS 8.0 Das Attribut preloadEnabled wurde hinzugefügt, um den Initialisierungsprozess zu initiieren, bevor eine Anforderung empfangen wird.
IIS 7.5 Das Element <application> wurde aktualisiert, um die Attribute serviceAutoStartEnabled und serviceAutoStartProvider einzuschließen.
IIS 7.0 Das <application>-Element wurde in IIS 7.0 eingeführt.
IIS 6.0 Das <application>-Element ersetzt die IIS 6.0 IIsWebVirtualDir- und IIsWebDirectory-Metabasisobjekte.

Setup

Das <application>-Element ist in der Standardinstallation von IIS 7 und höheren Versionen enthalten.

Gewusst wie

Erstellen einer neuen Webanwendung

  1. Öffnen Sie den Internet Information Services (IIS) Manager:

    • Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:

      • Klicken Sie der der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.

    • Wenn Sie Windows 8 oder Windows 8.1 verwenden:

      • Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
      • Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.

    • Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:

      • Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.

    • Wenn Sie Windows Vista oder Windows 7 verwenden:

      • Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
      • Doppelklicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.

  2. Erweitern Sie im Bereich Verbindungen den Servernamen, erweitern Sie Websites, und klicken Sie dann auf die Website, der Sie eine Anwendung hinzufügen möchten.

  3. Klicken Sie im Bereich Aktionen auf Anwendungen anzeigen, und klicken Sie dann auf Anwendung hinzufügen...
    Screenshot of Applications pane in I I S Manager with Add Application highlighted in Actions pane.

  4. Geben Sie im Dialogfeld Anwendung hinzufügen mindestens Informationen in den Alias:- und Physischer Pfad-Textfeldern ein, und klicken Sie dann auf OK.
    Screenshot of Add Application dialog box with fields for Alias and Physical path.

    Hinweis

    Klicken Sie auf Auswählen, um einen anderen Anwendungspool auszuwählen, klicken Sie auf Verbinden als, um die Anwendung so zu konfigurieren, dass Anmeldeinformationen von einem bestimmten Konto akzeptiert werden, und klicken Sie auf Testeinstellungen, um Authentifizierungs- und Autorisierungseinstellungen für die Anwendung zu testen.

Konfiguration

Das <application>-Element ist auf Serverebene in der Datei ApplicationHost.config konfigurierbar.

Attribute

Attribut Beschreibung
applicationPool Optionales Zeichenfolgeattribut.

Gibt den Anwendungspool an, dem die Anwendung zugewiesen ist.

Es ist kein Standardwert vorhanden.
enabledProtocols Optionales Zeichenfolgeattribut.

Gibt die Protokolle an, über die mit der Anwendung kommuniziert werden soll. Dieser Wert aktiviert HTTP- und HTTPS-Protokolle für die Anwendung.

Der Standardwert ist http.
path Erforderliches Zeichenfolgenattribut.

Gibt den virtuellen Pfad der Anwendung an. Muss ein eindeutiger Pfad innerhalb der übergeordneten Website sein.

Es ist kein Standardwert vorhanden.
preloadEnabled Optionales boolesches Attribut.

Gibt an, dass IIS eine Benutzeranforderung auf die Standardseite einer Anwendung oder eines virtuellen Verzeichnisses simuliert, sodass sie initialisiert wird. In der Tat startet IIS die Anwendung, wenn der Anwendungspool gestartet wird, ohne eine Anforderung erhalten zu haben. Dies erhöht die Leistung, indem Initialisierungsaufgaben ausgeführt werden, z. B. das Laden von verwalteten Modulen und das Kompilieren von verwaltetem Code. In den IIS-Protokollen wird kein Protokoll generiert. Die startMode-Einstellung des Anwendungspools muss auf AlwaysRunning eingestellt sein.

Der Standardwert ist False.
serviceAutoStartEnabled Optionales boolesches Attribut.

true, wenn der Autostart für diese Anwendung aktiviert ist; andernfalls false.

Der Standardwert ist false.
serviceAutoStartProvider Optionales Zeichenfolgeattribut.

Gibt den Namen des Autostartanbieters an, den der Windows-Prozessaktivierungsdienst (WAS) verwendet, wenn serviceAutoStartEnabled auf true festgelegt ist.

Es ist kein Standardwert vorhanden.

Untergeordnete Elemente

Element Beschreibung
virtualDirectory Optionales Element.

Gibt die Konfigurationseinstellungen für ein virtuelles Verzeichnis in der übergeordneten Anwendung an.
virtualDirectoryDefaults Optionales Element.

Gibt die Standardeinstellungen für alle virtuellen Verzeichnisse in der übergeordneten Anwendung an.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird ein <site>-Element mit zwei Anwendungen angezeigt. Das erste <application>-Element definiert die Stammanwendung für die Website zusammen mit dem virtuellen Stammverzeichnis für die Anwendung. Das zweite <application>-Element enthält die Konfigurationseinstellungen für eine CRM-Anwendung auf der Website. Das Path-Attribut definiert den Pfad für die Anwendung. Dieses <application>-Element enthält zwei <virtualDirectory>-Elemente. Im ersten wird das virtuelle Stammverzeichnis für die Anwendung definiert, und im zweiten wird ein virtuelles Image-Verzeichnis für die Anwendung definiert.

<site name="Contoso" id="2" serverAutoStart="true">
   <application path="/">
      <virtualDirectory path="/" physicalPath="C:\Contoso\Content" />
   </application>
   <application path="/CRM">
      <virtualDirectory path="/" physicalPath="C:\Contoso\Content\CRM" />
      <virtualDirectory path="/Images" physicalPath="E:\Images" />
   </application>
   <bindings>
      <binding protocol="http" bindingInformation="*:80:www.contoso.com" />
   </bindings>
</site>

Beispielcode

Die folgenden Beispiele erstellen eine neue Anwendung namens ShoppingCart mit einem virtuellen Verzeichnisstamm von C:\Inetpub\Contoso\ShoppingCart für eine Site mit dem Namen Contoso.

Hinweis

Wenn Sie eine Anwendung über die Eingabeaufforderung oder aus einem Skript erstellen, müssen Sie explizit ein virtuelles Stammverzeichnis für die Anwendung erstellen.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].[path='/ShoppingCart']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].[path='/ShoppingCart'].[path='/',physicalPath='C:\Inetpub\Contoso\ShoppingCart']" /commit:apphost

Hinweis

Sie müssen unbedingt den Commitparameterapphost festlegen, wenn Sie AppCmd.exe verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei ApplicationHost.config festgelegt.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
         ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");

         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElementCollection siteCollection = siteElement.GetCollection();
         ConfigurationElement applicationElement = siteCollection.CreateElement("application");

         applicationElement["path"] = @"/ShoppingCart";
         ConfigurationElementCollection applicationCollection = applicationElement.GetCollection();
         ConfigurationElement virtualDirectoryElement = applicationCollection.CreateElement("virtualDirectory");
         virtualDirectoryElement["path"] = @"/";
         virtualDirectoryElement["physicalPath"] = @"C:\Inetpub\Contoso\ShoppingCart";
         applicationCollection.Add(virtualDirectoryElement);
         siteCollection.Add(applicationElement);

         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
      Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Contoso")

      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim siteCollection As ConfigurationElementCollection = siteElement.GetCollection
      Dim applicationElement As ConfigurationElement = siteCollection.CreateElement("application")
      applicationElement("path") = "/ShoppingCart"
      Dim applicationCollection As ConfigurationElementCollection = applicationElement.GetCollection
      Dim virtualDirectoryElement As ConfigurationElement = applicationCollection.CreateElement("virtualDirectory")
      virtualDirectoryElement("path") = "/"
      virtualDirectoryElement("physicalPath") = "C:\Inetpub\Contoso\ShoppingCart"
      applicationCollection.Add(virtualDirectoryElement)
      siteCollection.Add(applicationElement)

      serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Contoso"]);

if (siteElementPos == -1) throw "Element not found!";

var siteElement = sitesCollection.Item(siteElementPos);
var siteCollection = siteElement.Collection;
var applicationElement = siteCollection.CreateNewElement("application");
applicationElement.Properties.Item("path").Value = "/ShoppingCart";
var applicationCollection = applicationElement.Collection;
var virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory");
virtualDirectoryElement.Properties.Item("path").Value = "/";
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\\Inetpub\\Contoso\\ShoppingCart";
applicationCollection.AddElement(virtualDirectoryElement);
siteCollection.AddElement(applicationElement);

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Contoso"))

If (siteElementPos = -1) Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set siteElement = sitesCollection.Item(siteElementPos)
Set siteCollection = siteElement.Collection
Set applicationElement = siteCollection.CreateNewElement("application")
applicationElement.Properties.Item("path").Value = "/ShoppingCart"
Set applicationCollection = applicationElement.Collection
Set virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory")
virtualDirectoryElement.Properties.Item("path").Value = "/"
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\Inetpub\Contoso\ShoppingCart"
applicationCollection.AddElement(virtualDirectoryElement)
siteCollection.AddElement(applicationElement)

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function