FTP 会话 <session>

概述

<sessions> 元素是动态生成的 <session> 元素的集合，每个元素都是在客户端连接到 FTP 服务器时由 FTP 服务动态创建的。 每个 <session> 元素的属性中包含的数据都是只读的；可以查询，但不能修改值。 每个 <session> 元素都包含一个 terminate 方法，可用于断开客户端会话的连接。

兼容性

版本	说明
IIS 10.0	<session> 元素在 IIS 10.0 中未进行修改。
IIS 8.5	<session> 元素在 IIS 8.5 中未进行修改。
IIS 8.0	<session> 元素在 IIS 8.0 中未进行修改。
IIS 7.5	<sessions> 元素的 <session> 元素作为 IIS 7.5 的功能提供。
IIS 7.0	<sessions> 元素的 <session> 元素是在 IIS 7.0 的独立下载项 FTP 7.0 中引入的。
IIS 6.0	空值

注意

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 服务器”。

   注意

   若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，除“FTP 服务”外还需选择“FTP 扩展性”。
   。

5. 单击“下一步”，然后在“选择功能”页上，再次单击“下一步”。

6. 在“确认安装选择”页上，单击“安装”。

7. 在“结果” 页面中单击“关闭” 。

Windows 8 或 Windows 8.1

1. 在“开始”屏幕上，将指针一直移动到左下角，右键单击“开始”按钮，然后单击“控制面板”。

2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。

3. 展开“Internet Information Services”，然后选择“FTP 服务器”。

   注意

   若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，还需选择“FTP 扩展性”。
   

4. 单击“确定”。

5. 单击“关闭” 。

Windows Server 2008 R2

1. 在任务栏上，单击“开始”，指向“管理工具”，然后单击“服务器管理器”。

2. 在“服务器管理器”层次结构窗格中，展开“角色”，然后单击“Web 服务器(IIS)”。

3. 在“Web 服务器(IIS)”窗格中，滚动到“角色服务”部分，然后单击“添加角色服务”。

4. 在“添加角色服务向导”的“选择角色服务”页，展开“FTP 服务器”。

5. 选择“FTP 服务”。

   注意

   若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，还需选择“FTP 扩展性”。
   

6. 单击 “下一步” 。

7. 在“确认安装选择”页中，单击“安装”。

8. 在“结果” 页面中单击“关闭” 。

Windows 7

1. 在任务栏上，单击“开始”，然后单击“控制面板”。

2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。

3. 展开“Internet Information Services”，然后展开“FTP 服务器”。

4. 选择“FTP 服务”。

   注意

   若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，还需选择“FTP 扩展性”。
   

5. 单击“确定”。

Windows Server 2008 或 Windows Vista

1. 从以下 URL 下载安装包：

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

2. 按照以下演练中的说明安装 FTP 服务：

   • 安装 FTP 7 并排除故障

操作方式

如何查看 FTP 站点的活动会话

1. 打开 Internet Information Services (IIS) 管理器：

   • 如果使用的是 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)管理器”。

2. 在“连接”窗格中，展开服务器名称，展开“站点”节点，然后单击站点名称。
   

3. 在站点的“主页”窗格中，双击“FTP 当前会话”。
   

4. 当前处于活动状态的 FTP 会话将显示在列表视图中。 可以通过在列表中突出显示活动会话，然后单击“操作”窗格中的“断开连接会话”来断开活动会话的连接。

配置

<session> 元素在站点级别创建。

特性

属性	数据类型	描述
bytesReceived	int64	指定会话已接收的累积字节数。
bytesSent	int64	指定已为会话发送的累积字节数。
clientIp	string	指定客户端的 IP 地址。
commandStartTime	string	指定最后一个命令启动的时间。
currentCommand	string	指定当前正在执行的命令。
lastErrorStatus	uint	指定最后一个 FTP 回复代码。
previousCommand	string	指定先前执行的命令。
sessionId	string	指定会话的唯一标识符。
sessionStartTime	string	指定会话启动的时间。
userName	string	指定会话的用户名，如果会话是匿名的，则为“<Anonymous>”。

子元素

无。

方法

方法	说明
Terminate	断开 FTP 客户端会话的连接。

配置示例

<session> 元素是动态生成的；无法对其进行配置。

代码示例

以下代码示例演示如何循环访问名为“ftp.example.com”的 FTP 站点的会话列表。 代码示例将列出每个会话的会话标识符、用户名和最后一个命令。

AppCmd.exe

无法使用 AppCmd.exe 查询 FTP 会话信息。

C#

using System;
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");
         ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();

         ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"ftp.example.com");
         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement ftpServerElement = siteElement.GetChildElement("ftpServer");
         ConfigurationElementCollection sessionsElement = ftpServerElement.GetChildElement("sessions").GetCollection();

         Console.WriteLine(String.Format("Active Sessions: {0}", sessionsElement.Count));

         foreach (ConfigurationElement sessionElement in sessionsElement)
         {
            Console.WriteLine(String.Format("\tSession ID: {0}",
                sessionElement.Attributes["sessionId"].Value.ToString()));
            Console.WriteLine(String.Format("\t\tUser Name: {0}",
                sessionElement.Attributes["userName"].Value.ToString()));
            Console.WriteLine(String.Format("\t\tPrevious Command: {0}",
                sessionElement.Attributes["previousCommand"].Value.ToString()));
         }
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

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 sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
      Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "ftp.example.com")
      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If
      Dim ftpServerElement As ConfigurationElement = siteElement.GetChildElement("ftpServer")
      Dim sessionsElement As ConfigurationElementCollection = ftpServerElement.GetChildElement("sessions").GetCollection
      Console.WriteLine(String.Format("Active Sessions: {0}", sessionsElement.Count))
      For Each sessionElement As ConfigurationElement In sessionsElement
         Console.WriteLine(String.Format(vbTab & "Session ID: {0}", sessionElement.Attributes("sessionId").Value.ToString))
         Console.WriteLine(String.Format(vbTab & vbTab & "User Name: {0}", sessionElement.Attributes("userName").Value.ToString))
         Console.WriteLine(String.Format(vbTab & vbTab & "Previous Command: {0}", sessionElement.Attributes("previousCommand").Value.ToString))
      Next
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


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 sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "ftp.example.com"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);

var ftpServerElement = siteElement.ChildElements.Item("ftpServer");
var sessionsElement = ftpServerElement.ChildElements.Item("sessions").Collection;

WScript.Echo("Active Sessions: " + sessionsElement.Count);

for (var i = 0; i < sessionsElement.Count; i++) {
   var sessionElement = sessionsElement.Item(i);
   WScript.Echo("\tSession ID: " + sessionElement.GetPropertyByName("sessionId").Value);
   WScript.Echo("\t\tUser Name: " + sessionElement.GetPropertyByName("userName").Value);
   WScript.Echo("\t\tPrevious Command: " + sessionElement.GetPropertyByName("previousCommand").Value);
}

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")

Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "ftp.example.com"))

If siteElementPos = -1 Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set siteElement = sitesCollection.Item(siteElementPos)
Set ftpServerElement = siteElement.ChildElements.Item("ftpServer")
Set sessionsElement = ftpServerElement.ChildElements.Item("sessions").Collection

WScript.Echo "Active Sessions: " & CLng(sessionsElement.Count)

For i = 0 To CLng(sessionsElement.Count)-1
   Set sessionElement = sessionsElement.Item(i)
   WScript.Echo vbTab & "Session ID: " & sessionElement.GetPropertyByName("sessionId").Value
   WScript.Echo vbTab & vbTab & "User Name: " & sessionElement.GetPropertyByName("userName").Value
   WScript.Echo vbTab & vbTab & "Previous Command: " & sessionElement.GetPropertyByName("previousCommand").Value
Next

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function