共用方式為

FTP 提供者定義 < 提供者定義提供者定義>

  • 發行項

概觀

元素 <providerDefinitions> 會指定自訂 FTP 提供者的集合。 元素 <providerDefinitions> 包含 語句的 <add> 集合，每個語句都會註冊 Managed 程式碼或機器碼 (COM) 提供者。 元素 <providerDefinitions> 也包含 <activation> 專案，定義自訂索引鍵/值組的集合，指定自訂提供者所需的任何參數。

從 FTP 7.5 開始，FTP 服務支援自訂驗證和角色、記錄和主目錄查閱的擴充性。 當您建立擴充性提供者時，必須先在 .NET 全域組件快取 (GAC) managed 程式碼提供者的 GAC) ，或在系統登錄中註冊原生程式碼 (COM) 提供者。 如需如何建立 FTP 自訂提供者的其他資訊，請參閱 Microsoft IIS.net 網站上的下一節：

開發 FTP 7.5

相容性

版本 備註
IIS 10.0 在 <providerDefinitions> IIS 10.0 中未修改專案。
IIS 8.5 未 <providerDefinitions> 在 IIS 8.5 中修改專案。
IIS 8.0 在 IIS 8.0 中未修改專案 <providerDefinitions> 。
IIS 7.5 元素 <providerDefinitions> 的 <system.ftpServer> 元素會隨附為 IIS 7.5 的功能。
IIS 7.0 元素 <providerDefinitions> 的 <system.ftpServer> 元素是在 FTP 7.0 中引進，這是 IIS 7.0 的個別下載。
IIS 6.0 IIS 6.0 中的 FTP 服務不支援擴充性。

注意

FTP 7.0 和 FTP 7.5 服務針對 IIS 7.0 隨附頻外，需要從下列 URL 下載並安裝模組：

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

使用 Windows 7 和 Windows Server 2008 R2 時，FTP 7.5 服務會隨附為 IIS 7.5 的功能，因此不再需要下載 FTP 服務。

安裝程式

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

Windows Server 2012 或 Windows Server 2012 R2

  1. 在工作列上，按一下 [伺服器管理員]。

  2. 在伺服器管理員中，按一下 [管理]功能表，然後按一下 [新增角色和功能]。

  3. 在 [ 新增角色和功能 精靈] 中，按 [下一步]。 選取安裝類型，然後按 [ 下一步]。 選取目的地伺服器，然後按 [ 下一步]。

  4. 在 [ 伺服器角色] 頁面上，展開 [Web 服務器] ([IIS) ]，然後選取 [ FTP 伺服器]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，除了FTP 服務之外，您還需要選取FTP 擴充性。

    [角色] 對話方塊的螢幕擷取畫面。F T P 擴充性會在下拉式功能表中反白顯示。 .

  5. 按 [下一步]，然後在 [ 選取功能 ] 頁面上，再次按 [ 下一步 ]。

  6. 在 [確認安裝選項] 頁面上，按一下 [安裝]。

  7. 在 [結果] 頁面上，按一下 [關閉]。

Windows 8 或Windows 8.1

  1. 在 [開始] 畫面上，將指標全部移至左下角，以滑鼠右鍵按一下 [開始] 按鈕，然後按一下[主控台]。

  2. 在主控台中，按一下 [程式和功能]，然後按一下 [開啟或關閉 Windows 功能]。

  3. 展開 [Internet Information Services]，然後選取 [FTP 伺服器]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。

    [Windows 功能] 對話方塊的螢幕擷取畫面。F T P 擴充性已反白顯示。

  4. 按一下 [確定]。

  5. 按一下 [關閉] 。

Windows Server 2008 R2

  1. 在工作列上，按一下 [開始]，指向 [系統管理工具]，然後按一下[伺服器管理員]。

  2. 在[伺服器管理員階層] 窗格中，展開 [角色]，然後按一下 [Web 服務器] (IIS) 。

  3. 在 [Web 服務器 (IIS) ] 窗格中，捲動至 [ 角色服務 ] 區段，然後按一下 [ 新增角色服務]。

  4. 在 [新增角色服務精靈] 的 [選取角色服務] 頁面上，展開[FTP 伺服器]。

  5. 選取 [FTP 服務]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。

    [選取角色服務] 頁面的螢幕擷取畫面。F T P 服務已反白顯示。

  6. 按一下 [下一步] 。

  7. 在 [確認安裝選項] 頁面上，按一下 [安裝]。

  8. 在 [結果] 頁面上，按一下 [關閉]。

Windows 7

  1. 在工作列上，按一下 [開始]，然後按一下[主控台]。

  2. 在主控台中，按一下 [程式和功能]，然後按一下 [開啟或關閉 Windows 功能]。

  3. 展開 [Internet Information Services]，然後展開 [FTP 伺服器]。

  4. 選取 [FTP 服務]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。

    [Windows 功能] 對話方塊的螢幕擷取畫面，其中已展開功能功能表。

  5. 按一下 [確定]。

Windows Server 2008 或 Windows Vista

  1. 從下列 URL 下載安裝套件：

  2. 請遵循下列逐步解說中的指示來安裝 FTP 服務：

作法

如何新增 FTP 網站的 Managed 程式碼自訂驗證提供者

注意

這些步驟假設已在伺服器的全域組件快取 (GAC.) 上安裝並註冊自訂 FTP 驗證提供者。如需如何註冊受控元件的詳細資訊，請參閱 Microsoft MSDN 網站上的 全域組件快取工具 (Gacutil.exe) 主題。

  1. 判斷擴充性提供者的元件資訊：

    • 在 Windows 檔案總管中，開啟您的 「C：\Windows\assembly」 路徑，其中 C： 是您的作業系統磁片磁碟機。
    • 找出元件。 例如 ，FtpAuthenticationDemo。
    • 以滑鼠右鍵按一下該組件，然後按一下 [內容]。
    • 複製 文化特性 值。 例如 ，中性。
    • 複製 版本 號碼。 例如， 1.0.0.0。
    • 複製 公開金鑰權杖 值。 例如， 426f62526f636b73。
    • 按一下 [取消]。

  2. 將擴充性提供者新增至 FTP 驗證提供者的全域清單：

    • 開啟 [Internet Information Services (IIS) 管理員] 。
    • 按一下 [ 連線 ] 窗格中的電腦名稱稱。
    • 按兩下主視窗中的 [FTP 驗證 ]。
      [I S Manager] 視窗的螢幕擷取畫面，其中顯示 F T P 驗證頁面。
    • 按一下 [動作] 窗格中的 [自訂提供者...]。
    • 按一下 [註冊] 。
      [自訂提供者] 對話方塊的螢幕擷取畫面。
    • 在 [ 名稱 ] 方塊中輸入自訂驗證提供者的易記名稱。 例如， FtpAuthenticationDemo。
    • 按一下受控提供者 (.NET) 。
      [新增自訂驗證提供者] 對話方塊的螢幕擷取畫面。
    • 使用您稍早複製的資訊，輸入擴充性提供者的元件資訊。 例如：
      FtpAuthentication.FtpAuthDemo、FtpAuthenticationDemo、version=1.0.0.0、Culture=neutral、PublicKeyToken=426f62526f636b73
    • 按一下 [確定]。
    • 清除提供者清單中的自訂驗證提供者核取方塊。
    • 按一下 [確定]。

  3. 新增 FTP 網站的自訂驗證提供者：

    • 在 Internet Information Services (IIS) Manager中開啟 FTP 網站。
    • 按兩下主視窗中的 [ FTP 驗證 ]。
    • 按一下 [動作] 窗格中的 [自訂提供者...]。
    • 檢查以在提供者清單中選取並啟用自訂驗證提供者。
    • 按一下 [確定]。

組態

元素 <providerDefinitions> 是在全域層級設定ApplicationHost.config。

屬性

無。

子元素

元素 描述
add 選擇性項目。

指定 Managed 程式碼或機器碼 (COM) 提供者的註冊資訊。
activation 選擇性項目。

指定自訂名稱/值組的集合，定義自訂提供者所需的任何參數。

注意： 這個元素已在 FTP 7.5 中新增。

組態範例

下列範例說明伺服器全域 <system.ftpServer> 元素中的數個組態設定。 更具體來說，此範例中的設定會示範如何：

  • 啟用 FTP 認證快取，並指定 10 分鐘的逾時， (600 秒。)

  • 將低埠設定為 5000，並將高埠設定為 6000 以進行資料通道通訊。

  • 啟用記錄，並指定每個月臺都會保留記錄檔，而且記錄檔會每天以 UTC 時間輪替。

  • 指定自訂 FTP 提供者，並指定該提供者的自訂參數。

  • 指定允許從本機主機進行 FTP 存取的全域 IP 限制，並拒絕存取 169.254.0.0 到 169.254.255.255 的 IP 位址區塊。

  • 使用下列選項設定要求篩選：

    • 封鎖對_vti_bin虛擬目錄的 FTP 存取，此目錄會與 FrontPage Server Extensions 搭配使用。
    • 封鎖數個與可執行檔相關聯的檔案類型。
    • 將 100MB 指定為檔案大小上限。

  • 新增允許系統管理員群組存取的全域授權規則。

  • 指定可用於 FTP 虛擬主機名稱的功能變數名稱語法。

<system.ftpServer>
   <caching>
      <credentialsCache enabled="true" flushInterval="600" />
   </caching>
   <firewallSupport lowDataChannelPort="5000" highDataChannelPort="6000" />
   <log centralLogFileMode="Site">
      <centralLogFile period="Daily" localTimeRollover="false" enabled="true" />
   </log>
   <providerDefinitions>
      <add name="FtpXmlAuthentication"
         type="FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73" />
      <activation>
         <providerData name="FtpXmlAuthentication">
            <add key="xmlFileName" value="C:\Inetpub\XmlSample\Users.xml" />
         </providerData>
      </activation>
   </providerDefinitions>
   <security>
      <ipSecurity enableReverseDns="false" allowUnlisted="true">
         <add ipAddress="169.254.0.0" subnetMask="255.255.0.0" allowed="false" />
         <add ipAddress="127.0.0.1" allowed="true" />
      </ipSecurity>
      <requestFiltering>
         <hiddenSegments>
            <add segment="_vti_bin" />
         </hiddenSegments>
         <fileExtensions allowUnlisted="true">
            <add fileExtension="exe" allowed="false" />
            <add fileExtension="cmd" allowed="false" />
            <add fileExtension="com" allowed="false" />
            <add fileExtension="bat" allowed="false" />
         </fileExtensions>
         <requestLimits maxAllowedContentLength="104857600" />
      </requestFiltering>
      <authorization>
         <add accessType="Allow" roles="administrators" permissions="Read, Write" />
      </authorization>
   </security>
   <serverRuntime>
      <hostNameSupport useDomainNameAsHostName="true" />
   </serverRuntime>
</system.ftpServer>

範例程式碼

下列範例會將自訂 FTP 提供者定義新增至伺服器，然後為該提供者新增資料參數。

AppCmd.exe

appcmd.exe set config -section:system.ftpServer/providerDefinitions /+"[name='FtpXmlAuthentication',type='FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73']" /commit:apphost

appcmd.exe set config -section:system.ftpServer/providerDefinitions /+"activation.[name='FtpXmlAuthentication']" /commit:apphost

appcmd.exe set config -section:system.ftpServer/providerDefinitions /+"activation.[name='FtpXmlAuthentication'].[key='xmlFileName',value='C:\Inetpub\wwwroot\App_Data\Users.xml']" /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 providerDefinitionsSection = config.GetSection("system.ftpServer/providerDefinitions");
         ConfigurationElementCollection providerDefinitionsCollection = providerDefinitionsSection.GetCollection();

         ConfigurationElement addElement = providerDefinitionsCollection.CreateElement("add");
         addElement["name"] = @"FtpXmlAuthentication";
         addElement["type"] = @"FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73";
         providerDefinitionsCollection.Add(addElement);

         ConfigurationElementCollection activationCollection = providerDefinitionsSection.GetCollection("activation");
         ConfigurationElement providerDataElement = activationCollection.CreateElement("providerData");
         providerDataElement["name"] = @"FtpXmlAuthentication";

         ConfigurationElementCollection providerDataCollection = providerDataElement.GetCollection();
         ConfigurationElement addElement1 = providerDataCollection.CreateElement("add");
         addElement1["key"] = @"xmlFileName";
         addElement1["value"] = @"C:\Inetpub\wwwroot\App_Data\Users.xml";
         providerDataCollection.Add(addElement1);
         activationCollection.Add(providerDataElement);

         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 providerDefinitionsSection As ConfigurationSection = config.GetSection("system.ftpServer/providerDefinitions")
      Dim providerDefinitionsCollection As ConfigurationElementCollection = providerDefinitionsSection.GetCollection

      Dim addElement As ConfigurationElement = providerDefinitionsCollection.CreateElement("add")
      addElement("name") = "FtpXmlAuthentication"
      addElement("type") = "FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73"
      providerDefinitionsCollection.Add(addElement)

      Dim activationCollection As ConfigurationElementCollection = providerDefinitionsSection.GetCollection("activation")
      Dim providerDataElement As ConfigurationElement = activationCollection.CreateElement("providerData")
      providerDataElement("name") = "FtpXmlAuthentication"

      Dim providerDataCollection As ConfigurationElementCollection = providerDataElement.GetCollection
      Dim addElement1 As ConfigurationElement = providerDataCollection.CreateElement("add")
      addElement1("key") = "xmlFileName"
      addElement1("value") = "C:\Inetpub\wwwroot\App_Data\Users.xml"
      providerDataCollection.Add(addElement1)
      activationCollection.Add(providerDataElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

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

var providerDefinitionsSection = adminManager.GetAdminSection("system.ftpServer/providerDefinitions", "MACHINE/WEBROOT/APPHOST");
var providerDefinitionsCollection = providerDefinitionsSection.Collection;

var addElement = providerDefinitionsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "FtpXmlAuthentication";
addElement.Properties.Item("type").Value = "FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73";
providerDefinitionsCollection.AddElement(addElement);

var activationCollection = providerDefinitionsSection.ChildElements.Item("activation").Collection;
var providerDataElement = activationCollection.CreateNewElement("providerData");
providerDataElement.Properties.Item("name").Value = "FtpXmlAuthentication";
var providerDataCollection = providerDataElement.Collection;

var addElement1 = providerDataCollection.CreateNewElement("add");
addElement1.Properties.Item("key").Value = "xmlFileName";
addElement1.Properties.Item("value").Value = "C:\\Inetpub\\wwwroot\\App_Data\\Users.xml";
providerDataCollection.AddElement(addElement1);
activationCollection.AddElement(providerDataElement);

adminManager.CommitChanges();

VBScript

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

Set providerDefinitionsSection = adminManager.GetAdminSection("system.ftpServer/providerDefinitions", "MACHINE/WEBROOT/APPHOST")
Set providerDefinitionsCollection = providerDefinitionsSection.Collection

Set addElement = providerDefinitionsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "FtpXmlAuthentication"
addElement.Properties.Item("type").Value = "FtpXmlAuthentication, FtpXmlAuthentication, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73"
providerDefinitionsCollection.AddElement(addElement)

Set activationCollection = providerDefinitionsSection.ChildElements.Item("activation").Collection
Set providerDataElement = activationCollection.CreateNewElement("providerData")
providerDataElement.Properties.Item("name").Value = "FtpXmlAuthentication"
Set providerDataCollection = providerDataElement.Collection

Set addElement1 = providerDataCollection.CreateNewElement("add")
addElement1.Properties.Item("key").Value = "xmlFileName"
addElement1.Properties.Item("value").Value = "C:\Inetpub\wwwroot\App_Data\Users.xml"
providerDataCollection.AddElement(addElement1)
activationCollection.AddElement(providerDataElement)

adminManager.CommitChanges()