共用方式為

WebDAV 全域設定 < globalSettings>

  • 發行項

概觀

元素 <globalSettings> 是全域 WebDAV 組態設定的父元素。 更具體來說，此元素包含屬性和鎖定提供者定義的設定。 WebDAV 模組的設計目的是要接受多個提供者，雖然只有單一提供者可用於 IIS 7 和 IIS 7.5。

注意

元素 <globalSettings> 不應該與 <siteDefaults> 元素混淆，這會定義網站的預設設定。

相容性

版本 備註
IIS 10.0 未在 IIS 10.0 中修改專案 <globalSettings> 。
IIS 8.5 未在 IIS 8.5 中修改專案 <globalSettings> 。
IIS 8.0 未在 IIS 8.0 中修改專案 <globalSettings> 。
IIS 7.5 元素 <globalSettings> 隨附為 IIS 7.5 的功能。
IIS 7.0 元素 <globalSettings> 是在 WebDAV 7.0 中引進，這是 IIS 7.0 的個別下載專案。 <propertyStores>WebDAV 7.0 中只有元素可用;元素 <lockStores> 是在 WebDAV 7.5 中引進。
IIS 6.0 N/A

注意

WebDAV 7.0 和 WebDAV 7.5 模組為 IIS 7.0 隨附頻外，需要從下列 URL 下載並安裝模組：

https://www.iis.net/expand/WebDAV

使用 Windows 7 和 Windows Server 2008 R2 時，WebDAV 7.5 模組隨附為 IIS 7.5 的功能，因此不再需要下載 WebDAV。

安裝程式

若要支援 Web 服務器的 WebDAV 發佈，您必須安裝 WebDAV 模組。 若要這樣做，請使用下列步驟。

Windows Server 2012 或 Windows Server 2012 R2

  1. 在工作列上，按一下 [伺服器管理員]。
  2. 在[伺服器管理員] 中，按一下 [管理] 功能表，然後按一下 [新增角色及功能]。
  3. 在 [ 新增角色及功能精 靈] 中，按 [ 下一步]。 選取安裝類型，然後按 [ 下一步]。 選取目的地伺服器，然後按 [ 下一步]。
  4. 在 [ 伺服器角色] 頁面上，依 序展開 [Web 服務器] (IIS) 、[ 網頁伺服器]、[ 一般 HTTP 功能]，然後選取 [ WebDAV 發佈]。 按一下 [下一步] 。
    顯示針對 Windows Server 2012 選取的 Web DAV 發佈螢幕擷取畫面。
  5. 在 [選取功能] 頁面上，按 [下一步]。
  6. 在 [確認安裝選項] 頁面上，按一下 [安裝]。
  7. 在 [結果] 頁面上，按一下 [關閉]。

Windows 8 或 Windows 8.1

  1. 在 [開始] 畫面上，將指標一路移至左下角，以滑鼠右鍵按一下 [開始] 按鈕，然後按一下[主控台]。
  2. 在主控台中，按一下 [程式和功能]，然後按一下 [開啟或關閉 Windows 功能]。
  3. 依序展開 [Internet Information Services]、[ 萬維網服務]、[ 一般 HTTP 功能]，然後選取 [ WebDAV 發佈]。
    顯示針對 Windows 8 選取的 Web DAV 發佈螢幕擷取畫面。
  4. 按一下 [確定]。
  5. 按一下 [關閉] 。

Windows Server 2008 R2

  1. 在工作列上，按一下 [開始]，指向 [系統管理工具]，然後按一下[伺服器管理員]。
  2. 在[伺服器管理員階層] 窗格中，展開 [角色]，然後按一下 [Web 服務器] (IIS) 。
  3. 在 [ Web Server (IIS) ] 窗格中，捲動至 [ 角色服務 ] 區段，然後按一下 [ 新增角色服務]。
  4. 在 [新增角色服務精靈] 的 [選取角色服務] 頁面上，展開 [一般 HTTP 功能]，選取 [WebDAV 發佈]，然後按 [下一步]。
    此螢幕擷取畫面顯示 [新增角色服務精靈] 中針對 Windows Server 2008 選取的 Web DAV 發佈。
  5. 在 [確認安裝選項] 頁面上，按一下 [安裝]。
  6. 在 [結果] 頁面上，按一下 [關閉]。

Windows 7

  1. 在工作列上，按一下 [開始]，然後按一下[主控台]。
  2. 在主控台中，按一下 [程式和功能]，然後按一下[開啟或關閉 Windows 功能]。
  3. 依序展開 [Internet Information Services]、[ World Wide Web 服務] 和 [ 一般 HTTP 功能]。
  4. 選取 [WebDAV 發佈]，然後按一下 [ 確定]。
    顯示針對 Windows 7 選取的 Web DAV 發佈螢幕擷取畫面。

Windows Server 2008 或 Windows Vista

作法

如何設定網站的 WebDAV 鎖定

  1. 開啟 [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。

  2. 在 [ 連線] 窗格中，展開伺服器名稱、展開 [ 站 台] 節點，然後按一下月臺的名稱。

  3. 在網站的 [ 首頁 ] 窗格中，按兩下 [WebDAV 撰寫規則]。
    顯示 [伺服器首頁] 窗格的螢幕擷取畫面，其中已選取 [Web DAV 撰寫規則]。

  4. 顯示[WebDAV 撰寫規則]頁面時，按一下 [動作] 窗格中的 [WebDAV 設定]。

  5. 顯示 [WebDAV 設定 ] 頁面時，請在 [ 鎖定行為 ] 區段中指定下列選項：

    • 將 [允許鎖定] 設定為 True。
    • 針對 [鎖定存放區]，從下拉式清單中選擇 [webdav_simple_lock ]。
    • 將 [需要鎖定] 設定為 您想要的設定。
      顯示 [Web DAV 設定] 窗格的螢幕擷取畫面。

  6. 完成這些步驟之後，請按一下 [動作] 窗格中的 [套用]。

如何設定網站的 WebDAV 屬性

  1. 開啟 [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。

  2. 在 [ 連線] 窗格中，展開伺服器名稱、展開 [ 站 台] 節點，然後按一下網站的名稱。

  3. 在網站的 [ 首頁 ] 窗格中，按兩下 [WebDAV 撰寫規則]。
    顯示 [預設網站首頁] 窗格的螢幕擷取畫面。已選取 Web DAV。

  4. 顯示[WebDAV 撰寫規則]頁面時，按一下 [動作] 窗格中的 [WebDAV 設定]。
    顯示 [Web DAV 撰寫規則] 窗格的螢幕擷取畫面。

  5. 顯示 [WebDAV 設定 ] 頁面時，請在 [ 屬性行為 ] 區段中指定下列選項：

    • 將 [允許匿名屬性查詢 ] 設定為 False。

    • 將 [允許自訂屬性 ] 設定為 [True]。

    • 將 [允許具有無限深度的屬性查詢 ] 設定為 False。

      顯示 [Web DAV 設定] 窗格的螢幕擷取畫面。三個欄位已變更。

  6. 按一下省略號 (...) 按鈕以啟動命名空間集合編輯器。
    顯示 [命名空間集合編輯器] 對話方塊的螢幕擷取畫面。

  7. 按一下[新增]，然後從下拉式清單中選擇[webdav_simple_prop

  8. 指定 XmlNameSpace 的 「*」，然後按一下 [ 確定]。

  9. 完成上述步驟之後，請按一下 [動作] 窗格中的 [套用]。

組態

元素 <globalSettings> 只能在ApplicationHost.config檔案的全域層級進行設定。 會忽略網站或應用層級或Web.config檔案中的任何設定。

屬性

無。

子元素

元素 描述
propertyStores 選擇性項目。

指定屬性存放區提供者的集合。
lockStores 選擇性項目。 指定鎖定存放區提供者的集合。

組態範例

下列範例會列出 WebDAV 伺服器的範例 <globalSettings> 專案。 此範例會定義鎖定和屬性的內建簡單提供者，並啟用伺服器的 WebDAV 鎖定。

<system.webServer>
      <webdav>
         <globalSettings>
            <propertyStores>
               <add name="webdav_simple_prop" image="%windir%\system32\inetsrv\webdav_simple_prop.dll" />
            </propertyStores>
            <lockStores>
               <add name="webdav_simple_lock" image="%windir%\system32\inetsrv\webdav_simple_lock.dll" />
            </lockStores>
         </globalSettings>
         <authoring>
            <locks enabled="true" lockStore="webdav_simple_lock" />
         </authoring>
      </webdav>
   </system.webServer>

範例程式碼

注意

propertyStores當您安裝 WebDAV 時，和 lockStores 集合會填入內建屬性和鎖定提供者。 目前無法擴充這些提供者集合，因此本節中的程式碼範例僅供參考。

下列範例會設定 WebDAV 全域設定，以在安裝 WebDAV 模組時，重新新增複製到您系統的內建屬性和鎖定提供者。

AppCmd.exe

appcmd.exe set config -section:system.webServer/webdav/globalSettings /+"propertyStores.[name='webdav_simple_prop',image='%windir%\system32\inetsrv\webdav_simple_prop.dll']" /commit:apphost

appcmd.exe set config -section:system.webServer/webdav/globalSettings /+"lockStores.[name='webdav_simple_lock',image='%windir%\system32\inetsrv\webdav_simple_lock.dll']" /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 globalSettingsSection = config.GetSection("system.webServer/webdav/globalSettings");

         ConfigurationElementCollection propertyStoresCollection = globalSettingsSection.GetCollection("propertyStores");

         ConfigurationElement addElement = propertyStoresCollection.CreateElement("add");
         addElement["name"] = @"webdav_simple_prop";
         addElement["image"] = @"%windir%\system32\inetsrv\webdav_simple_prop.dll";
         propertyStoresCollection.Add(addElement);

         ConfigurationElementCollection lockStoresCollection = globalSettingsSection.GetCollection("lockStores");

         ConfigurationElement addElement1 = lockStoresCollection.CreateElement("add");
         addElement1["name"] = @"webdav_simple_lock";
         addElement1["image"] = @"%windir%\system32\inetsrv\webdav_simple_lock.dll";
         lockStoresCollection.Add(addElement1);

         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 globalSettingsSection As ConfigurationSection = config.GetSection("system.webServer/webdav/globalSettings")

      Dim propertyStoresCollection As ConfigurationElementCollection = globalSettingsSection.GetCollection("propertyStores")

      Dim addElement As ConfigurationElement = propertyStoresCollection.CreateElement("add")
      addElement("name") = "webdav_simple_prop"
      addElement("image") = "%windir%\system32\inetsrv\webdav_simple_prop.dll"
      propertyStoresCollection.Add(addElement)

      Dim lockStoresCollection As ConfigurationElementCollection = globalSettingsSection.GetCollection("lockStores")

      Dim addElement1 As ConfigurationElement = lockStoresCollection.CreateElement("add")
      addElement1("name") = "webdav_simple_lock"
      addElement1("image") = "%windir%\system32\inetsrv\webdav_simple_lock.dll"
      lockStoresCollection.Add(addElement1)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var globalSettingsSection = adminManager.GetAdminSection("system.webServer/webdav/globalSettings", "MACHINE/WEBROOT/APPHOST");

var propertyStoresCollection = globalSettingsSection.ChildElements.Item("propertyStores").Collection;

var addElement = propertyStoresCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "webdav_simple_prop";
addElement.Properties.Item("image").Value = "%windir%\\system32\\inetsrv\\webdav_simple_prop.dll";
propertyStoresCollection.AddElement(addElement);

var lockStoresCollection = globalSettingsSection.ChildElements.Item("lockStores").Collection;

var addElement1 = lockStoresCollection.CreateNewElement("add");
addElement1.Properties.Item("name").Value = "webdav_simple_lock";
addElement1.Properties.Item("image").Value = "%windir%\\system32\\inetsrv\\webdav_simple_lock.dll";
lockStoresCollection.AddElement(addElement1);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set globalSettingsSection = adminManager.GetAdminSection("system.webServer/webdav/globalSettings", "MACHINE/WEBROOT/APPHOST")

Set propertyStoresCollection = globalSettingsSection.ChildElements.Item("propertyStores").Collection

Set addElement = propertyStoresCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "webdav_simple_prop"
addElement.Properties.Item("image").Value = "%windir%\system32\inetsrv\webdav_simple_prop.dll"
propertyStoresCollection.AddElement(addElement)

Set lockStoresCollection = globalSettingsSection.ChildElements.Item("lockStores").Collection

Set addElement1 = lockStoresCollection.CreateNewElement("add")
addElement1.Properties.Item("name").Value = "webdav_simple_lock"
addElement1.Properties.Item("image").Value = "%windir%\system32\inetsrv\webdav_simple_lock.dll"
lockStoresCollection.AddElement(addElement1)

adminManager.CommitChanges()