預設 FTP 訊息訊息 <>

概觀

元素 <messages> 是用來指定 FTP 服務會顯示給 FTP 用戶端的訊息。 當 FTP 用戶端連接到 FTP 月臺時，會顯示為 bannerMessage 、 greetingMessage 和 maxClientsMessage 屬性指定的訊息，而當 FTP 用戶端與 FTP 月臺中斷連線時，就會顯示 屬性所 exitMessage 指定的訊息。

屬性 suppressDefaultBanner 可以與 屬性搭配使用， bannerMessage 以區分您的 FTP 伺服器類型。 如果預設橫幅已隱藏，且未在 屬性中 bannerMessage 指定橫幅訊息，則 FTP 伺服器會在 FTP 用戶端連線到伺服器時顯示空白橫幅。

屬性 expandVariables 會指定是否要在 FTP 訊息中顯示一組特定的使用者變數。 如果此屬性設定為 true，FTP 服務會在 FTP 訊息中顯示使用者變數;否則，所有訊息文字都會顯示為輸入。 支援的使用者變數如下：

User 變數	描述
%BytesReceived%	從伺服器傳送至目前會話之用戶端的位元組數目。
%BytesSent%	從用戶端傳送至目前會話之伺服器的位元組數目。
%SessionID%	目前會話的唯一識別碼。
%SiteName%	裝載目前會話的 FTP 網站名稱。
%UserName%	目前登入使用者的帳戶名稱。

屬性 allowLocalDetailedErrors 會指定當 FTP 用戶端連接到伺服器本身上的 FTP 伺服器時，是否要顯示詳細的錯誤訊息。 這些錯誤訊息包含伺服器系統管理員可用來針對問題進行疑難排解的詳細資訊。 如果此屬性設定為 true，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 擴充性。
   .

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

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

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

Windows 8 或Windows 8.1

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

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

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

   注意

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

4. 按一下 [確定]。

5. 按一下 [關閉] 。

Windows Server 2008 R2

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

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

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

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

5. 選取 [FTP 服務]。

   注意

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

6. 按一下 [下一步] 。

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

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

Windows 7

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

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

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

4. 選取 [FTP 服務]。

   注意

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

5. 按一下 [確定]。

Windows Server 2008 或 Windows Vista

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

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

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

   • 安裝和疑難排解 FTP 7

作法

如何設定所有 FTP 月臺的預設自訂訊息

1. (IIS) 管理員開啟 Internet Information Services：

   • 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：

     • 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。

   • 如果您使用 Windows 8 或 Windows 8.1：

     • 按住Windows鍵，按字母X，然後按一下[主控台]。
     • 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

   • 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：

     • 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。

   • 如果您使用 Windows Vista 或 Windows 7：

     • 在工作列上，按一下 [開始]，然後按一下[主控台]。
     • 按兩下 [系統管理工具]，然後按兩下 [ Internet Information Services] (IIS) Manager。

2. 在 [ 連線] 窗格中，按一下伺服器名稱。

3. 在伺服器的 [ 首頁 ] 窗格中，按兩下 [FTP 訊息] 功能。
   

4. 設定下列選項：

   • 按一下以選取 [ 隱藏預設橫幅 ] 選項。
   • 按一下即可選取 [訊息中的支援使用者變數 ] 選項。
   • 輸入 橫幅訊息的 「這是我的 FTP 伺服器」。
   • 輸入 歡迎訊息的 「Hello %UserName%！」 。
   • 在 Exit 訊息中輸入 「Goodbye %UserName%！」 。
     

5. 在 [動作] 窗格中按一下 [套用]。

組態

屬性

子元素

無。

組態範例

下列組態範例會顯示定義自訂預設橫幅訊息並啟用本機詳細錯誤訊息的伺服器範例 <messages> 元素。

<siteDefaults>
     <ftpServer>
      <messages bannerMessage="Welcome!" allowLocalDetailedErrors="true" />
     </ftpServer>
</siteDefaults>

範例程式碼

下列程式碼範例說明如何設定自訂預設橫幅訊息，並啟用本機詳細錯誤訊息。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.ftpServer.messages.bannerMessage:"Welcome!" /siteDefaults.ftpServer.messages.allowLocalDetailedErrors:"True" /commit:apphost

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 messagesElement = ftpServerElement.GetChildElement("messages");
            messagesElement["bannerMessage"] = @"Welcome!";
            messagesElement["allowLocalDetailedErrors"] = 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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")
      Dim ftpServerElement As ConfigurationElement = siteDefaultsElement.GetChildElement("ftpServer")

      Dim messagesElement As ConfigurationElement = ftpServerElement.GetChildElement("messages")
         messagesElement("bannerMessage") = "Welcome!"
         messagesElement("allowLocalDetailedErrors") = True

      serverManager.CommitChanges()
   End Sub
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 messagesElement = ftpServerElement.ChildElements.Item("messages");
   messagesElement.Properties.Item("bannerMessage").Value = "Welcome!";
   messagesElement.Properties.Item("allowLocalDetailedErrors").Value = true;

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 messagesElement = ftpServerElement.ChildElements.Item("messages")
   messagesElement.Properties.Item("bannerMessage").Value = "Welcome!"
   messagesElement.Properties.Item("allowLocalDetailedErrors").Value = True

adminManager.CommitChanges()