FTP 記錄選項 < 記錄>
概觀
元素 <system.ftpServer/log> 會指定 FTP 服務的全域記錄檔設定。 更具體來說，元素上的 <system.ftpServer/log> 屬性會指定下列選項：
centralLogFileMode- 這個屬性會指定 FTP 服務應該使用每個伺服器) (集中記錄，還是每個月臺的月臺記錄 () 。- 如果您指定中央記錄，則會保留所有 FTP 月臺的單一記錄檔。
- 如果您指定月臺記錄，則每個 FTP 月臺都會寫入個別記錄檔。
logInUTF8- 這個屬性會指定記錄檔應該以 UTF8 格式編碼。
當您指定中央記錄時，可以使用 <centralLogFile> 子項目來設定中央記錄檔的選項。
相容性
| 版本 | 備註 |
|---|---|
| IIS 10.0 | 未在 IIS 10.0 中修改專案 <log> 。 |
| IIS 8.5 | 未在 IIS 8.5 中修改專案 <log> 。 |
| IIS 8.0 | 未在 IIS 8.0 中修改專案 <log> 。 |
| IIS 7.5 | 元素 <log> 的 <system.ftpServer> 元素隨附為 IIS 7.5 的功能。 |
| IIS 7.0 | 元素 <log> 的 <system.ftpServer> 元素是在 FTP 7.0 中引進，這是 IIS 7.0 的個別下載專案。 |
| IIS 6.0 | 元素 <system.ftpServer> 及其子項目會取代位於 LM/MSFTPSVC 中繼基底路徑中的 IIS 6.0 FTP 設定。 |
使用 Windows 7 和 Windows Server 2008 R2 時，FTP 7.5 服務隨附為 IIS 7.5 的功能，因此不再需要下載 FTP 服務。
安裝程式
若要支援 Web 服務器的 FTP 發佈，您必須安裝 FTP 服務。 若要這樣做，請使用下列步驟。
Windows Server 2012 或 Windows Server 2012 R2
在工作列上，按一下 [伺服器管理員]。
在[伺服器管理員] 中，按一下 [管理] 功能表，然後按一下 [新增角色及功能]。
在 [ 新增角色及功能精 靈] 中，按 [ 下一步]。 選取安裝類型，然後按 [ 下一步]。 選取目的地伺服器，然後按 [ 下一步]。
在 [ 伺服器角色] 頁面上，展開 [ Web 服務器 (IIS) ]，然後選取 [ FTP 伺服器]。
注意
支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，除了FTP 服務之外，您還需要選取[FTP 擴充性]。
.按 [下一步]，然後在 [ 選取功能 ] 頁面上，再次按 [ 下一步 ]。
在 [確認安裝選項] 頁面上，按一下 [安裝]。
在 [結果] 頁面上，按一下 [關閉]。
Windows 8 或 Windows 8.1
在 [開始] 畫面上，將指標一路移至左下角，以滑鼠右鍵按一下 [開始] 按鈕，然後按一下[主控台]。
在主控台中，按一下 [程式和功能]，然後按一下 [開啟或關閉 Windows 功能]。
展開 [Internet Information Services]，然後選取 [ FTP 伺服器]。
注意
支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。
按一下 [確定]。
按一下 [關閉] 。
Windows Server 2008 R2
在工作列上，按一下 [開始]，指向 [系統管理工具]，然後按一下[伺服器管理員]。
在[伺服器管理員階層] 窗格中，展開 [角色]，然後按一下 [Web 服務器] (IIS) 。
在 [ Web Server (IIS) ] 窗格中，捲動至 [ 角色服務 ] 區段，然後按一下 [ 新增角色服務]。
在 [新增角色服務精靈] 的 [選取角色服務] 頁面上，展開[FTP 伺服器]。
選取 [FTP 服務]。
注意
支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。
按一下 [下一步] 。
在 [確認安裝選項] 頁面上，按一下 [安裝]。
在 [結果] 頁面上，按一下 [關閉]。
Windows 7
在工作列上，按一下 [開始]，然後按一下[主控台]。
在主控台中，按一下 [程式和功能]，然後按一下[開啟或關閉 Windows 功能]。
展開 [Internet Information Services]，然後展開 [ FTP 伺服器]。
選取 [FTP 服務]。
注意
支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。
按一下 [確定]。
Windows Server 2008 或 Windows Vista
從下列 URL 下載安裝套件：
請遵循下列逐步解說中的指示來安裝 FTP 服務：
作法
如何設定 FTP 服務的月臺層級或伺服器層級記錄
開啟 [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。
在 [ 連線] 窗格中，按一下伺服器名稱。
在 [ 首頁] 窗格中，按兩下 FTP 記錄 功能。
![在網站 [首頁] 窗格的 [F T P] 區段中選取的 F T P 記錄螢幕擷取畫面。](index/_static/image9.png)
在 每 一個下拉式清單中，選擇下列其中一個選項：
- 選擇 [站 台] 以指定每個 FTP 月臺將寫入個別記錄檔。
- 選擇 [伺服器 ] 以指定所有 FTP 月臺的單一記錄檔。
在 [動作] 窗格中，按一下 [套用]。
組態
專案 <system.ftpServer/log> 是在全域層級設定ApplicationHost.config。
屬性
| 屬性 | 描述 | ||||||
|---|---|---|---|---|---|---|---|
centralLogFileMode |
選擇性列舉屬性。 指定 FTP 服務是否應該使用每個伺服器) 的集中記錄 (，還是每個月臺的月臺記錄 () 。
Site。 |
||||||
logInUTF8 |
選擇性 Boolean 屬性。 指定 IIS 是否應該以 UCS 轉換格式 8 (UTF-8) 記錄 FTP 伺服器的所有字串。 此設定適用于 FTP 伺服器上所有網站的文字模式記錄。 預設值是 true。 |
子元素
| 元素 | 描述 |
|---|---|
centralLogFile |
選擇性項目。 指定中央記錄檔的設定。 |
注意
名為 <customLogging> 的未使用元素已在 FTP 7.0 架構中宣告，但已從 FTP 7.5 架構中移除，因此不應使用。
組態範例
下列組態範例會啟用 FTP 服務的中央檔案記錄。
<system.ftpServer>
<log centralLogFileMode="Central">
<centralLogFile enabled="true" />
</log>
</system.ftpServer>
範例程式碼
下列範例會啟用 FTP 服務的中央檔案記錄。
AppCmd.exe
appcmd.exe set config -section:system.ftpServer/log /centralLogFileMode:"Central" /commit:apphost
appcmd.exe set config -section:system.ftpServer/log /centralLogFile.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 logSection = config.GetSection("system.ftpServer/log");
logSection["centralLogFileMode"] = @"Central";
ConfigurationElement centralLogFileElement = logSection.GetChildElement("centralLogFile");
centralLogFileElement["enabled"] = true;
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 logSection As ConfigurationSection = config.GetSection("system.ftpServer/log")
logSection("centralLogFileMode") = "Central"
Dim centralLogFileElement As ConfigurationElement = logSection.GetChildElement("centralLogFile")
centralLogFileElement("enabled") = True
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var logSection = adminManager.GetAdminSection("system.ftpServer/log", "MACHINE/WEBROOT/APPHOST");
logSection.Properties.Item("centralLogFileMode").Value = "Central";
var centralLogFileElement = logSection.ChildElements.Item("centralLogFile");
centralLogFileElement.Properties.Item("enabled").Value = true;
adminManager.CommitChanges();
VBScript
Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set logSection = adminManager.GetAdminSection("system.ftpServer/log", "MACHINE/WEBROOT/APPHOST")
logSection.Properties.Item("centralLogFileMode").Value = "Central"
Set centralLogFileElement = logSection.ChildElements.Item("centralLogFile")
centralLogFileElement.Properties.Item("enabled").Value = True
adminManager.CommitChanges()