共用方式為

預設 FTP 檔案處理設定檔 < 案Handling>

  • 發行項

概觀

元素 <fileHandling> 是用來指定 FTP 服務處理檔案作業的方式。 例如，屬性會 keepPartialUploads 設定 FTP 服務是否應該保留部分傳輸的檔案，例如檔案傳輸提前結束時。

相容性

版本 備註
IIS 10.0 未在 IIS 10.0 中修改專案 <fileHandling> 。
IIS 8.5 未在 IIS 8.5 中修改專案 <fileHandling> 。
IIS 8.0 未在 IIS 8.0 中修改專案 <fileHandling> 。
IIS 7.5 元素 <fileHandling> 的 <ftpServer> 元素隨附為 IIS 7.5 的功能。
IIS 7.0 元素 <fileHandling> 的 <ftpServer> 元素是在 FTP 7.0 中引進，這是 IIS 7.0 的個別下載專案。
IIS 6.0 N/A

注意

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

https://www.iis.net/downloads/microsoft/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 Server (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 功能精靈的螢幕擷取畫面，其中顯示 [開啟或關閉 Windows 功能] 功能表。

  5. 按一下 [確定]。

Windows Server 2008 或 Windows Vista

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

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

作法

如何設定 FTP 伺服器的預設檔案處理選項

  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. 在 [網站]窗格中，按一下 [動作] 窗格中的[設定 FTP 月臺預設值]。 [F T P 月臺預設值] 對話方塊的螢幕擷取畫面。

  4. 在 [ FTP 月臺預設值 ] 對話方塊中，展開 [ 檔案處理]，然後指定下列選項：

    • 如果 FTP 服務應該允許目前上傳之檔案的讀取權限，則為 [允許讀取檔案時上傳] 指定True;否則，請指定False。

    • 如果 FTP 服務應該允許重新命名的檔案覆寫現有檔案，請針對 [重新命名時允許取代] 指定True;否則，請指定False。

    • 如果 FTP 服務應該保留部分上傳的檔案，請針對[保留部分上傳] 指定True;否則，請指定False。

      注意

      保留部分上傳的檔案可讓 FTP 用戶端重新連線並繼續上傳。
      [F T P 網站預設值] 對話方塊的螢幕擷取畫面，其中已展開 [檔案處理] 選項。

  5. 按一下 [確定]。

組態

屬性

屬性 描述
allowReadUploadsInProgress 選擇性 Boolean 屬性。

如果 FTP 服務應該允許目前上傳之檔案的讀取權限，則為true;否則為false。

預設值是 false。
allowReplaceOnRename 選擇性 Boolean 屬性。

如果 FTP 服務應該允許重新命名的檔案覆寫現有的檔案，則為true;否則為false。

預設值是 false。
keepPartialUploads 選擇性 Boolean 屬性。

如果 FTP 服務應該保留部分上傳的檔案，則為true;否則為false。

預設值是 false。

子元素

無。

組態範例

下列組態範例會顯示設定為預設保留部分上傳檔案之伺服器的範例 <fileHandling> 專案。

<siteDefaults>
   <ftpServer>
      <fileHandling keepPartialUploads="false" />
   </ftpServer>
</siteDefaults>

範例程式碼

下列程式碼範例示範如何設定 FTP 服務，以預設保留部分上傳的檔案。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.ftpServer.fileHandling.keepPartialUploads:"False" /commit:apphost.ftpServer.logFile.enabled:"True" /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");
         ConfigurationElement ftpServerElement = siteDefaultsElement.GetChildElement("ftpServer");

         ConfigurationElement fileHandlingElement = ftpServerElement.GetChildElement("fileHandling");
         fileHandlingElement["keepPartialUploads"] = false;

         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 ftpServerElement As ConfigurationElement = siteDefaultsElement.GetChildElement("ftpServer")

      Dim fileHandlingElement As ConfigurationElement = ftpServerElement.GetChildElement("fileHandling")
      fileHandlingElement("keepPartialUploads") = False

      serverManager.CommitChanges()
   End Sub

End Module
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 ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer");

var fileHandlingElement = ftpServerElement.ChildElements.Item("fileHandling");
fileHandlingElement.Properties.Item("keepPartialUploads").Value = false;

adminManager.CommitChanges();

VBScript

Set adminManager = 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 ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer")

Set fileHandlingElement = ftpServerElement.ChildElements.Item("fileHandling")
fileHandlingElement.Properties.Item("keepPartialUploads").Value = False

adminManager.CommitChanges()