共用方式為

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

  • 發行項

概觀

專案的 <add> 元素 <providerDefinitions> 會指定 Managed 程式碼或機器碼 (COM) 提供者的註冊資訊。

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

針對 FTP 7.5 進行開發

相容性

版本 備註
IIS 10.0 未在 IIS 10.0 中修改專案 <add> 。
IIS 8.5 未在 IIS 8.5 中修改專案 <add> 。
IIS 8.0 未在 IIS 8.0 中修改專案 <add> 。
IIS 7.5 元素 <add> 的 <providerDefinitions> 元素隨附為 IIS 7.5 的功能。
IIS 7.0 元素 <add> 的 <providerDefinitions> 元素是在 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 擴充性]。
    在 Windows Server 2012 介面中選取的 F T P 服務和 F T P 擴充性螢幕擷取畫面。 .

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

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

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

Windows 8 或 Windows 8.1

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

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

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

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。
    在 Windows 8 介面中選取的 F T P 服務和 F T P 擴充性螢幕擷取畫面。

  4. 按一下 [確定]。

  5. 按一下 [關閉] 。

Windows Server 2008 R2

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

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

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

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

  5. 選取 [FTP 服務]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。
    在 Windows Server 2008 介面中選取的 F T P 服務和 F T P 擴充性螢幕擷取畫面。

  6. 按一下 [下一步] 。

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

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

Windows 7

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

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

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

  4. 選取 [FTP 服務]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。
    在 Windows 7 介面中選取的 F T P 服務和 F T P 擴充性螢幕擷取畫面。

  5. 按一下 [確定]。

Windows Server 2008 或 Windows Vista

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

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

作法

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

注意

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

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

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

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

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

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

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

組態

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

屬性

屬性 描述
name 必要的字串屬性。

指定自訂提供者的易記名稱。

沒有任何預設值。
type 選擇性字串屬性。

指定 Managed 程式碼提供者的類型。

沒有任何預設值。
clsid 選擇性字串屬性。

指定原生程式碼提供者的 COM 類別識別碼。

沒有任何預設值。

子元素

無。

組態範例

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

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

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

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

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

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

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

    • 封鎖對_vti_bin虛擬目錄的 FTP 存取，此目錄會與 FrontPage 伺服器延伸模組搭配使用。
    • 封鎖數個與可執行檔相關聯的檔案類型。
    • 將 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設定這些設定時，請務必將 認可 參數 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);

         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)

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

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)

adminManager.CommitChanges()