預設系結系 < 結>

發行項
07/19/2023

概觀

元素 <bindings> 會設定所有 IIS 7 網站的預設系結資訊。

這個專案可以包含專案的 <binding> 集合。集合中的每個元素都會定義一組個別的系結資訊，要求可用來連絡網站。例如，如果您的網站要求使用者同時使用 HTTP 通訊協定和 HTTPS 通訊協定連絡它，您必須為每個通訊協定定義系結。

您也可以在元素的 <site> 元素中使用 <clear /><bindings> 專案，覆寫繼承自伺服器層級 <siteDefaults> 元素的系結預設值。

相容性

版本	備註
IIS 10.0	未在 IIS 10.0 中修改專案 `<bindings>` 。
IIS 8.5	未在 IIS 8.5 中修改專案 `<bindings>` 。
IIS 8.0	未在 IIS 8.0 中修改專案 `<bindings>` 。
IIS 7.5	未在 IIS 7.5 中修改專案 `<bindings>` 。
IIS 7.0	元素 `<bindings>` 是在 IIS 7.0 中引進。
IIS 6.0	集合 `<bindings>` 會取代 IIS 6.0 IIsWebServer Metabase 物件上ServerBindings屬性的區段。

安裝程式

元素 <bindings> 包含在 IIS 7 的預設安裝中。

作法

如何設定伺服器的月臺預設值

開啟 [Internet Information Services (IIS) 管理員：
- 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：
  - 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services (IIS) Manager]。
- 如果您使用 Windows 8 或 Windows 8.1：
  - 按住Windows鍵，按字母X，然後按一下[主控台]。
  - 按一下 [系統管理工具]，然後按兩下 [ Internet Information Services (IIS) Manager]。
- 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：
  - 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。
- 如果您使用 Windows Vista 或 Windows 7：
  - 在工作列上，按一下 [開始]，然後按一下[主控台]。
  - 按兩下 [系統管理工具]，然後按兩下 [ Internet Information Services] (IIS) Manager。
在 [ 連線] 窗格中，展開伺服器名稱，然後按一下 [ 月臺] 節點。
在伺服器的 [網站] 窗格中，按一下 [動作] 窗格中的[設定網站預設值...]。
在 [ 網站預設值 ] 對話方塊中，指定所有網站的預設選項，然後按一下 [ 確定]。

組態

您可以新增 <bindings> 伺服器的元素，其中包含定義伺服器預設通訊協定系結的個別 <binding> 元素集合。您也可以在元素的 <site> 元素中使用 <clear /><bindings> 專案，覆寫繼承自伺服器層級 <siteDefaults> 元素的系結預設值。

屬性

無。

子元素

元素	描述
`binding`	選擇性項目。設定預設系結。
`clear`	選擇性項目。清除預設系結的集合。

組態範例

下列組態範例會指定 IIS 7 的預設 bindings 選項。

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

範例程式碼

下列程式碼範例會設定 IIS 7 的預設 bindings 選項。

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

注意

當您使用 AppCmd.exe 來設定這些設定時，請務必將認可參數 apphost 設定為。這會將組態設定認可至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()

共用方式為