Hinzufügen einer Standardbindungsbindung <binding>

Artikel
06/11/2024

Übersicht

Mit dem Element <binding> des Elements <bindings> können Sie die informationen konfigurieren, die für Anforderungen für die Kommunikation mit einer Website erforderlich sind.

Sie können Bindungsinformationen konfigurieren, wenn Sie eine Website erstellen, oder Sie können die Bindungsinformationen bearbeiten, nachdem Sie die Website erstellt haben. Bindungsinformationen umfassen das Protokoll, das Clients für die Kommunikation mit dem Standort, der IP-Adresse des Standorts, der Portnummer und einem Hostheader verwenden.

Das Element <binding> enthält zwei Attribute zum Konfigurieren der Bindungsinformationen: bindingInformation und Protokoll. Das Attribut bindingInformation enthält die IP-Adresse, die Portnummer und optional den Hostheader für die Website. Das Attribut Protokoll definiert das Protokoll, das für die Kommunikation mit der Website verwendet werden soll.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<binding>` Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<binding>` Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das Attribut `sslFlags` wurde hinzugefügt, um die Bindung anzugeben, die für Secure Sockets Layer-Zertifikate verwendet wird.
IIS 7.5	Das `<binding>`-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<binding>`-Element der `<bindings>`-Auflistung 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 <binding>-Element ist in der Standardinstallation von IIS 7 und höheren Versionen enthalten.

Gewusst wie

Hinzufügen von Standardbindungsinformationen zu einem Server

Ö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-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 Verwaltung und doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
Wählen Sie im Bereich Verbindungen den Servernamen aus.
Doppelklicken Sie im Bereich Start auf den Konfigurations-Editor.
Wechseln sie zu system.applicationHost/sites in Abschnitt.
Klicken Sie im Dialogfeld Sitebindungen auf Hinzufügen....
Erweitern Sie siteDefaults.
Wählen Sie bindings aus, und klicken Sie dann auf die Auslassungspunkte rechts, um den Sammlungs-Editor zu öffnen.
Klicken Sie auf Hinzufügen, und geben Sie Werte für bindingInformation, protocolund sslFlags ein.
Schließen Sie den Auflistungs-Editor, und klicken Sie im Bereich Aktion auf Übernehmen.

Konfiguration

Sie können Standard-<binding>-Elemente innerhalb des <bindings> Elements im <siteDefaults>-Abschnitt der ApplicationHost.config-Datei hinzufügen.

Attribute Beschreibung

bindingInformation Erforderliches Zeichenfolgenattribut.

Gibt Informationen an, die mit einer Website kommuniziert werden sollen. Beispielsweise enthält eine Websitebindung die IP-Adresse (oder nicht angegebene IP-Adressen), die Portnummer und einen optionalen Hostheader, der für die Kommunikation mit der Website verwendet wird.

protocol Erforderliches Zeichenfolgenattribut.

Gibt das Protokoll für die Kommunikation mit einer Website an.

sslFlags

Optionales uint Attribut, das wie flags-Typ funktioniert, mit den folgenden möglichen Flags:

Wert	Beschreibung
`0`	Die sichere Verbindung, die mit einer IP-/Port-Kombination hergestellt wurde. Nur ein Zertifikat kann an eine Kombination aus IP-Adresse und Port gebunden werden.
`1`	Die sichere Verbindung, die mit der Portnummer und dem Hostnamen hergestellt wurde, der mithilfe von Server Name Indication (SNI) abgerufen wurde.
`2`	Die sichere Verbindung wird mithilfe des zentralen SSL-Zertifikatspeichers hergestellt.
`4`	Deaktivieren Sie HTTP/2.
`8`	OcSP-Heftung deaktivieren.
`16`	Deaktivieren Sie QUIC.
`32`	Deaktivieren Sie TLS 1.3 über TCP.
`64`	Legacy-TLS deaktivieren.

Die zentralisierte SSL-Zertifikatunterstützung ermöglicht das Erstellen eines zentralen Zertifikatspeichers, der mehrere Zertifikatdateien enthalten kann. Die Zertifikatdateien können benannt werden, um den Hostnamen zu entsprechen, die sie enthalten. Dies ermöglicht das Erstellen einer Bindung, die nur einen Port erfordert, anstelle einer IP-/Port- oder Hostnamen-/Portkombination. Wenn eine Anforderung eingeht, stimmt IIS den Port ab, bestimmt den Hostnamen aus der Anforderung und durchsucht den zentralisierten Zertifikatspeicher nach einer Zertifikatdatei mit einem übereinstimmenden Namen. Es verwendet dieses Zertifikat.

Bei einem Servernamenindikator (Server Name Indicator, SNI) wird der Hostname als Teil des SSL-Handshakes ausgetauscht. SNI ist im Dialogfeld "Websitebindung hinzufügen" aktiviert, wenn eine Bindung mit einem HTTPS-Typ hinzugefügt wird. Dies ist nützlich für SSL-Verbindungen, die mehrere Server auf einer einzelnen Netzwerkadresse hosten.

Werte größer als 4 werden nur in IIS 10, Version 1809 und höher, unterstützt. Der Standardwert ist 0.

Untergeordnete Elemente

Keine.

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

In den folgenden Codebeispielen werden die bindings-Standardoptionen für IIS 7 konfiguriert.

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 unbedingt den Commitparameter 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()

Freigeben über