既定の FTP メッセージ <messages>

概要

<messages> 要素は、FTP サービスが FTP クライアントに表示するメッセージを指定するために使われます。 bannerMessage、greetingMessage、maxClientsMessage 属性に指定したメッセージは、FTP クライアントが FTP サイトに接続したときに表示され、exitMessage 属性で指定したメッセージは、FTP クライアントが FTP サイトから切断されたときに表示されます。

suppressDefaultBanner 属性を bannerMessage 属性と組み合わせて使うと、FTP サーバーの種類を偽装できます。 既定のバナーが抑制されており、バナー メッセージが bannerMessage 属性で指定されていない場合、FTP クライアントがサーバーに接続すると、FTP サーバーに空白のバナーが表示されます。

expandVariables 属性には、FTP メッセージに特定のユーザー変数セットを表示するかどうかを指定します。 この属性が true に設定されている場合、FTP サービスは FTP メッセージにユーザー変数を表示します。それ以外の場合は、すべてのメッセージ テキストが入力したとおりに表示されます。 サポートされているユーザー変数は次のとおりです。

User Variable (ユーザー変数)	説明
%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 サーバー] を選びます。

   Note

   FTP サービスに対して ASP.NET メンバーシップ認証または IIS マネージャー認証をサポートするには、[FTP Service] に加えて[FTP 拡張] も選択する必要があります。
   .

5. [次へ] をクリックし、[機能の選択] ページで再度 [次へ] をクリックします。

6. [インストール オプションの確認] ページで、[インストール] をクリックします。

7. [結果] ページで、 [閉じる]をクリックします。

Windows 8 または Windows 8.1

1. [スタート] 画面で、ポインターを左下隅まで移動し、[スタート] ボタンを右クリックし、[コントロール パネル] をクリックします。

2. [コントロール パネル]で [プログラムと機能] をクリックし、[Windows の機能の有効化または無効化] をクリックします。

3. [インターネット インフォメーション サービス] を展開し、[FTP サーバー] を展開します。

   Note

   FTP サービスに対して ASP.NET メンバーシップ認証または IIS マネージャー認証をサポートするには、[FTP 拡張] も選択する必要があります。
   

4. OK をクリックします。

5. 閉じるをクリックします。

Windows Server 2008 R2

1. タスク バーで [スタート] をクリックし、[管理ツール] をポイントして、[サーバー マネージャ] をクリックします。

2. [サーバー マネージャ] 階層ウィンドウで [役割] を展開し、[Web サーバー (IIS)] をクリックします。

3. [Web サーバー (IIS)] ウィンドウで、[役割サービス] セクションまでスクロールし、[役割サービスの追加] をクリックします。

4. [役割サービスの追加] ウィザードの [役割サービスの選択] ページで [FTP サーバー] を展開します。

5. [FTP Service] を選択します。

   Note

   FTP サービスに対して ASP.NET メンバーシップ認証または IIS マネージャー認証をサポートするには、[FTP 拡張] も選択する必要があります。
   

6. 次へ をクリックします。

7. [インストール オプションの確認] ページで、[インストール] をクリックします。

8. [結果] ページで、 [閉じる]をクリックします。

Windows 7

1. タスク バーで、[スタート]、[コントロール パネル] の順にクリックします。

2. [コントロール パネル]で [プログラムと機能] をクリックし、[Windows の機能の有効化または無効化] をクリックします。

3. [インターネット インフォメーション サービス]、[FTP サーバー] の順に展開します。

4. [FTP Service] を選択します。

   Note

   FTP サービスに対して ASP.NET メンバーシップ認証または IIS マネージャー認証をサポートするには、[FTP 拡張] も選択する必要があります。
   

5. OK をクリックします。

Windows Server 2008 または Windows Vista

1. 次の URL からインストール パッケージをダウンロードします。

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

2. 次のチュートリアルの手順に従って、FTP サービスをインストールします。

   • FTP 7 のインストールとトラブルシューティング

操作方法

すべての FTP サイトに対して既定のカスタマイズされたメッセージを構成する方法

1. インターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 または Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8 または Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

   • Windows Server 2008 または Windows Server 2008 R2 を使用している場合:

     • タスク バーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows Vista または Windows 7 を使用している場合:

     • タスク バーで、[スタート]、[コントロール パネル] の順にクリックします。
     • [管理ツール] をダブルクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ペインでサーバー名をクリックします。

3. サーバーの [ホーム] ペインで、[FTP メッセージ] 機能をダブルクリックします。
   

4. 次のオプションを構成します:

   • [既定のバナーを表示しない] オプションをクリックしてオンにします。
   • [メッセージ内のユーザー変数をサポートする] オプションをクリックしてオンにします。
   • [バナー] メッセージに「This is my FTP server」と入力します。
   • [接続時のメッセージ] メッセージに「Hello %UserName%!」と入力します。
   • [接続切断時のメッセージ] メッセージに「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()