Sites <Sites>

Artikel
03/25/2024

Übersicht

Die <sites>-Abschnittsgruppe enthält Konfigurationseinstellungen für alle Websites auf einem IIS 7-Server. Das <sites>-Element enthält eine Sammlung von <site>-Elementen. Wenn Sie eine neue Website erstellen, fügt IIS der Auflistung ein <site>-Element hinzu.

Jedes <site>-Element enthält Konfigurationseinstellungen für eine separate Website, die in Ihrer IIS 7-Installation gehostet wird. Die Standard-Website und ihre Einstellungen werden beispielsweise in einem <site>-Element definiert, das sich zwischen dem öffnenden und dem schließenden Tag des <sites>-Elements befindet. Dort befinden sich auch die Konfigurationselemente für jede weitere Site, die Sie erstellen.

Die <sites>-Abschnittsgruppe kann auch die Elemente <siteDefaults>, <applicationDefaults>und <virtualDirectoryDefaults> enthalten. Das <siteDefaults>-Element definiert die Standardkonfigurationseinstellungen für jede Site, die auf dem Server läuft, das <applicationDefaults>-Element definiert die Standardkonfigurationseinstellungen für jede Anwendung, die auf dem Server läuft, und das <virtualDirectoryDefaults>-Element definiert die Standardkonfigurationseinstellungen für jedes virtuelle Verzeichnis, das auf dem Server läuft.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<sites>` Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<sites>` Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<sites>` Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<sites>` Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<sites>`-Element wurde in IIS 7.0 eingeführt.
IIS 6.0	Die `<sites>`-Sammlung ersetzt das IIS 6.0 IIsWebServer-Metabasisobjekt.

Setup

Das <sites>-Element ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Wenn Sie eine neue Website in IIS 7 konfigurieren, müssen Sie der Website einen Websitenamen und einen physischen Pfad zuweisen. Es gibt auch eine Reihe optionaler Konfigurationseinstellungen, die Sie festlegen können. Wenn Sie beabsichtigen, die Standardwebsite auf Ihrem IIS 7-Server weiterhin zu verwenden, müssen Sie die Bindungsinformationen für die neue Website ändern. Dazu können Sie entweder den Port ändern oder einen Hostnamen für die neue Website eingeben.

So erstellen Sie eine neue Webseite

Öffnen Sie den Internet Information Services (IIS) Manager:
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie 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.
Erweitern Sie im Bereich Verbindungen den Servernamen, und klicken Sie anschließend auf Sites.
Klicken Sie im Aktionsbereich auf Website hinzufügen...
Geben Sie im Dialogfeld Website hinzufügen mindestens Informationen in die Textfelder Websitename und Physischer Pfad ein, und wählen Sie aus, ob Sie Informationen in das Textfeld Hostname eingeben oder die Nummer im Feld Port ändern möchten.
Klicken Sie im IIS-Manager auf die Schaltfläche Aktualisieren, um zu überprüfen, ob die Website gestartet wurde.

Konfiguration

Sie konfigurieren das <sites>-Element auf Serverebene in der Datei ApplicationHost.config.

Attribute

Keine

Untergeordnete Elemente

Element	Beschreibung
`applicationDefaults`	Optionales Element. Gibt Standardeinstellungen für alle Anwendungen auf dem Server an.
`site`	Optionales Element. Gibt Konfigurationseinstellungen für eine Site an.
`siteDefaults`	Optionales Element. Gibt Standardeinstellungen für alle Sites auf dem Server an.
`virtualDirectoryDefaults`	Optionales Element. Gibt Standardeinstellungen für alle virtuellen Verzeichnisse auf dem Server an.

Konfigurationsbeispiel

Das folgende Standardelement <sites> ist in der Stammdatei ApplicationHost.config in IIS 7 konfiguriert.

<sites>
   <site name="Default Web Site" id="1">
      <application path="/">
         <virtualDirectory path="/" physicalPath="%SystemDrive%\inetpub\wwwroot" />
      </application>
      <bindings>
         <binding protocol="http" bindingInformation="*:80:" />
      </bindings>
   </site>
   <siteDefaults>
      <logFile logFormat="W3C" directory="%SystemDrive%\inetpub\logs\LogFiles" />
      <traceFailedRequestsLogging directory="%SystemDrive%\inetpub\logs\FailedReqLogFiles" />
    </siteDefaults>
   <applicationDefaults applicationPool="DefaultAppPool" />
   <virtualDirectoryDefaults allowSubDirConfig="true" />
</sites>

Kompatibilität

In Kombination mit dem <site>-Element ersetzt das <sites>-Element die IIS 6.0-IIsWebServer-Metabase-Eigenschaft.

Beispielcode

In den folgenden Beispielen wird eine neue Website namens Contoso mit einer ID von 2 erstellt und eine Bindung für das HTTP-Protokoll über Port 80 mit einem Hostheader von „www.contoso.com“ festgelegt. Der physische Pfad für die neue Website lautet „C:\Inetpub\www.contoso.com\wwwroot“.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso',id='2',serverAutoStart='True']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso',id='2'].bindings.[protocol='http',bindingInformation='*:80:www.contoso.com']" /commit:apphost

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

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso',id='2'].[path='/'].[path='/',physicalPath='C:\Inetpub\www.contoso.com\wwwroot']" /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 = sitesCollection.CreateElement("site");
         siteElement["name"] = @"Contoso";
         siteElement["id"] = 2;
         siteElement["serverAutoStart"] = true;

         ConfigurationElementCollection bindingsCollection = siteElement.GetCollection("bindings");
         ConfigurationElement bindingElement = bindingsCollection.CreateElement("binding");
         bindingElement["protocol"] = @"http";
         bindingElement["bindingInformation"] = @"*:80:www.contoso.com";
         bindingsCollection.Add(bindingElement);

         ConfigurationElementCollection siteCollection = siteElement.GetCollection();
         ConfigurationElement applicationElement = siteCollection.CreateElement("application");
         applicationElement["path"] = @"/";
         ConfigurationElementCollection applicationCollection = applicationElement.GetCollection();
         ConfigurationElement virtualDirectoryElement = applicationCollection.CreateElement("virtualDirectory");
         virtualDirectoryElement["path"] = @"/";
         virtualDirectoryElement["physicalPath"] = @"C:\Inetpub\www.contoso.com\wwwroot";
         applicationCollection.Add(virtualDirectoryElement);
         siteCollection.Add(applicationElement);
         sitesCollection.Add(siteElement);

         serverManager.CommitChanges();
      }
   }
}

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 = sitesCollection.CreateElement("site")
      siteElement("name") = "Contoso"
      siteElement("id") = 2
      siteElement("serverAutoStart") = True

      Dim bindingsCollection As ConfigurationElementCollection = siteElement.GetCollection("bindings")
      Dim bindingElement As ConfigurationElement = bindingsCollection.CreateElement("binding")
      bindingElement("protocol") = "http"
      bindingElement("bindingInformation") = "*:80:www.contoso.com"
      bindingsCollection.Add(bindingElement)

      Dim siteCollection As ConfigurationElementCollection = siteElement.GetCollection
      Dim applicationElement As ConfigurationElement = siteCollection.CreateElement("application")
      applicationElement("path") = "/"
      Dim applicationCollection As ConfigurationElementCollection = applicationElement.GetCollection
      Dim virtualDirectoryElement As ConfigurationElement = applicationCollection.CreateElement("virtualDirectory")
      virtualDirectoryElement("path") = "/"
      virtualDirectoryElement("physicalPath") = "C:\Inetpub\www.contoso.com\wwwroot"
      applicationCollection.Add(virtualDirectoryElement)
      siteCollection.Add(applicationElement)
      sitesCollection.Add(siteElement)

      serverManager.CommitChanges()
   End Sub
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 siteElement = sitesCollection.CreateNewElement("site");
siteElement.Properties.Item("name").Value = "Contoso";
siteElement.Properties.Item("id").Value = 2;
siteElement.Properties.Item("serverAutoStart").Value = true;

var bindingsCollection = siteElement.ChildElements.Item("bindings").Collection;
var bindingElement = bindingsCollection.CreateNewElement("binding");
bindingElement.Properties.Item("protocol").Value = "http";
bindingElement.Properties.Item("bindingInformation").Value = "*:80:www.contoso.com";
bindingsCollection.AddElement(bindingElement);

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

adminManager.CommitChanges();

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

Set siteElement = sitesCollection.CreateNewElement("site")
siteElement.Properties.Item("name").Value = "Contoso"
siteElement.Properties.Item("id").Value = 2
siteElement.Properties.Item("serverAutoStart").Value = True

Set bindingsCollection = siteElement.ChildElements.Item("bindings").Collection
Set bindingElement = bindingsCollection.CreateNewElement("binding")
bindingElement.Properties.Item("protocol").Value = "http"
bindingElement.Properties.Item("bindingInformation").Value = "*:80:www.contoso.com"
bindingsCollection.AddElement bindingElement

Set siteCollection = siteElement.Collection
Set applicationElement = siteCollection.CreateNewElement("application")
applicationElement.Properties.Item("path").Value = "/"
Set applicationCollection = applicationElement.Collection
Set virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory")
virtualDirectoryElement.Properties.Item("path").Value = "/"
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\Inetpub\www.contoso.com\wwwroot"
applicationCollection.AddElement(virtualDirectoryElement)
siteCollection.AddElement applicationElement
sitesCollection.AddElement siteElement

adminManager.CommitChanges()

Freigeben über

Sites <Sites>

Übersicht

Kompatibilität

Setup

Gewusst wie

So erstellen Sie eine neue Webseite

Konfiguration

Attribute

Untergeordnete Elemente

Konfigurationsbeispiel

Kompatibilität

Beispielcode

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Feedback

Zusätzliche Ressourcen