Compartir a través de

Enlaces predeterminados <enlaces>

  • Artículo

Información general

El elemento <bindings> configura la información de enlace predeterminada para todos los sitios web de IIS 7.

Este elemento puede contener una colección de elementos <binding>. Cada elemento de la colección define un conjunto independiente de información de enlace que una solicitud puede usar para ponerse en contacto con el sitio web. Por ejemplo, si el sitio requiere que los usuarios se comuniquen con él mediante el protocolo HTTP y el protocolo HTTPS, debe definir un enlace para cada protocolo.

También puede usar un elemento <clear /> en el elemento <bindings> de un elemento <site> para invalidar los valores predeterminados de enlace heredados del elemento <siteDefaults> de nivel de servidor.

Compatibilidad

Versión Notas
IIS 10.0 El elemento <bindings> no se modificó en IIS 10.0.
IIS 8.5 El elemento <bindings> no se modificó en IIS 8.5.
IIS 8.0 El elemento <bindings> no se modificó en IIS 8.0.
IIS 7.5 El elemento <bindings> no se modificó en IIS 7.5.
IIS 7.0 El elemento <bindings> se introdujo en IIS 7.0.
IIS 6,0 La colección <bindings> reemplaza las secciones de la propiedad ServerBindings en el objeto de metabase IIsWebServer de IIS 6.0.

Configuración

El elemento <bindings> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

Configuración de los valores predeterminados del sitio para un servidor

  1. Abra el Administrador de Internet Information Services (IIS):

    • Si usa Windows Server 2012 o Windows Server 2012 R2:

      • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).

    • Si usa Windows 8 o Windows 8.1:

      • Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
      • En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

    • Si usa Windows Server 2008 o Windows Server 2008 R2:

      • En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

    • Si usa Windows Vista o Windows 7:

      • En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
      • Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

  2. En el panel Conexiones, expanda el nombre del servidor y haga clic en el nodo Sitios.

  3. En el panel Sitios del servidor, haga clic en Establecer valores predeterminados del sitio web... en el panel Acciones.
    Screenshot of the Sites pane showing the Default Web Site option.

  4. En el cuadro de diálogo Valores predeterminados del sitio web, especifique las opciones predeterminadas para todos los sitios web y, a continuación, haga clic en Aceptar.

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

Configuración

Puede agregar un elemento <bindings> para un servidor, que puede contener una colección de elementos <binding> individuales que definen los enlaces de protocolo predeterminados para el servidor. También puede usar un elemento <clear /> en el elemento <bindings> de un elemento <site> para invalidar los valores predeterminados de enlace heredados del elemento <siteDefaults> de nivel de servidor.

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción
binding Elemento opcional.

Configura un enlace predeterminado.
clear Elemento opcional.

Borra la colección de enlaces predeterminados.

Ejemplo de configuración

En el ejemplo de configuración siguiente se especifican las opciones bindings predeterminadas para IIS 7.

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

Código de ejemplo

Los ejemplos de código siguientes configuran las opciones bindings predeterminadas para 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

Nota:

Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo ApplicationHost.config.

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()