Freigeben über

Standardbindungen <bindings>

  • Artikel

Übersicht

Das <bindings>-Element konfiguriert die Standardbindungsinformationen für alle IIS 7-Websites.

Dieses Element kann eine Auflistung von <binding>-Elementen enthalten. Jedes Element in der Auflistung definiert einen separaten Satz von Bindungsinformationen, die eine Anforderung zum Kontaktieren der Website verwenden kann. Wenn Ihre Website beispielsweise erfordert, dass Benutzer sie über das HTTP-Protokoll und das HTTPS-Protokoll kontaktieren können, müssen Sie eine Bindung für jedes Protokoll definieren.

Sie können auch ein <clear />-Element im <bindings>-Element eines <site>-Elements verwenden, um die Bindungsstandardwerte außer Kraft zu setzen, die vom <siteDefaults>-Element auf Serverebene geerbt werden.

Kompatibilität

Version Hinweise
IIS 10.0 Das <bindings>-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5 Das <bindings>-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0 Das <bindings>-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5 Das <bindings>-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0 Das <bindings>-Element wurde in IIS 7.0 eingeführt.
IIS 6.0 Die Sammlung <bindings> ersetzt Abschnitte der Eigenschaft ServerBindings im IIS 6.0 IIsWebServer-Metabasisobjekt.

Setup

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

Gewusst wie

Konfigurieren der Sitestandardwerte für einen Server

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

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

      • Klicken Sie auf der Taskleiste auf Server-Manager, dann auf Tools und danach auf Internetinformationsdienste-Manager (IIS).

    • 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 Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS).

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

      • Klicken Sie in der Taskleiste auf Start, zeigen Sie auf Verwaltungstools, und klicken Sie dann auf Manager für Internetinformationsdienste(IIS).

    • Wenn Sie Windows Vista oder Windows 7 verwenden:

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

  2. Erweitern Sie im Bereich Verbindungen den Servernamen, und klicken Sie dann auf den Knoten Sites.

  3. Klicken Sie im Bereich Sites des Servers im Bereich Aktionen auf Website-Standardwerte festlegen.
    Screenshot of the Sites pane showing the Default Web Site option.

  4. Geben Sie im Dialogfeld Website-Standardwerte Ihre Standardoptionen für alle Websites an, und klicken Sie dann auf OK.

    Screenshot of the Website Defaults dialog box showing the General and Behavior sections.

Konfiguration

Sie können ein <bindings>-Element für einen Server hinzufügen, das eine Sammlung einzelner <binding>-Elemente enthalten kann, die die Standardprotokollbindungen für den Server definieren. Sie können auch ein <clear />-Element im <bindings>-Element eines <site>-Elements verwenden, um die Bindungsstandardwerte außer Kraft zu setzen, die vom <siteDefaults>-Element auf Serverebene geerbt werden.

Attribute

Keine

Untergeordnete Elemente

Element Beschreibung
binding Optionales Element.

Konfiguriert eine Standardbindung.
clear Optionales Element.

Löscht die Auflistung von Standardbindungen.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel werden die bindings-Standardoptionen für IIS 7 festgelegt.

<system.applicationHost>
   <sites>
      <siteDefaults>
         <bindings>
            <binding protocol="http" bindingInformation="127.0.0.1:8080:" />
         </bindings>
      </siteDefaults>
   </sites>
</system.applicationHost>

Beispielcode

Die folgenden Codebeispiele konfigurieren die Standard-bindings-Optionen für IIS 7.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.bindings.[protocol='http',bindingInformation='*:8080:contoso.com'].bindingInformation:"127.0.0.1:8080:" /commit:apphost

Hinweis

Sie müssen den commit-Parameter auf apphost 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");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElementCollection bindingsCollection = siteDefaultsElement.GetCollection("bindings");
         ConfigurationElement bindingElement = bindingsCollection.CreateElement("binding");
         bindingElement["protocol"] = @"http";
         bindingElement["bindingInformation"] = @"127.0.0.1:8080:";
         bindingsCollection.Add(bindingElement);

         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 siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim bindingsCollection As ConfigurationElementCollection = siteDefaultsElement.GetCollection("bindings")
      Dim bindingElement As ConfigurationElement = bindingsCollection.CreateElement("binding")
      bindingElement("protocol") = "http"
      bindingElement("bindingInformation") = "127.0.0.1:8080:"
      bindingsCollection.Add(bindingElement)

      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 siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var bindingsCollection = siteDefaultsElement.ChildElements.Item("bindings").Collection;
var bindingElement = bindingsCollection.CreateNewElement("binding");
bindingElement.Properties.Item("protocol").Value = "http";
bindingElement.Properties.Item("bindingInformation").Value = "127.0.0.1:8080:";
bindingsCollection.AddElement(bindingElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set bindingsCollection = siteDefaultsElement.ChildElements.Item("bindings").Collection
Set bindingElement = bindingsCollection.CreateNewElement("binding")
bindingElement.Properties.Item("protocol").Value = "http"
bindingElement.Properties.Item("bindingInformation").Value = "127.0.0.1:8080:"
bindingsCollection.AddElement(bindingElement)

adminManager.CommitChanges()