Opciones de registro central de FTP <centralLogFile>

Información general

El elemento <centralLogFile> especifica la configuración del archivo de registro central, que se usa al especificar centralLogFileMode para el atributo centralLogFileMode del elemento <system.ftpServer/log>. Al especificar el registro central, se conservará un único archivo de registro para todos los sitios FTP.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <centralLogFile> no se modificó en IIS 10.0.
IIS 8.5	El elemento <centralLogFile> no se modificó en IIS 8.5.
IIS 8.0	El elemento <centralLogFile> no se modificó en IIS 8.0.
IIS 7.5	El elemento <centralLogFile> del elemento <log> se incluye como una característica de IIS 7.5.
IIS 7.0	El elemento <centralLogFile> del elemento <log> se introdujo en FTP 7.0, que era una descarga independiente para IIS 7.0.
IIS 6,0	El elemento <system.ftpServer> y sus elementos secundarios reemplazan los valores FTP de IIS 6.0 que se encontraban en la ruta de acceso de metabase LM/MSFTPSVC.

Nota:

Los servicios FTP 7.0 y FTP 7.5 se enviaron fuera de banda para IIS 7.0, lo que requería descargar e instalar el servicio desde la siguiente dirección URL:

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

Con Windows 7 y Windows Server 2008 R2, el servicio FTP 7.5 se incluye como característica para IIS 7.5, por lo que la descarga del servicio FTP ya no es necesaria.

Configuración

Para admitir la publicación de FTP para el servidor web, debe instalar el servicio FTP. Para ello, siga estos pasos.

Windows Server 2012 o Windows Server 2012 R2

1. En la barra de tareas, haga clic en Administrador del servidor.

2. En Administrador del servidor, haga clic en el menú Administrar y, después, haga clic en Agregar roles y características.

3. En el asistente para Agregar roles y características, haga clic en Siguiente. Seleccione el tipo de instalación y haga clic en Siguiente. Seleccione el servidor de destino y haga clic en Siguiente.

4. En la página Roles de servidor, expanda Servidor web (IIS) y, después, seleccione Servidor FTP.

   Nota:

   Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP, además de Servicio FTP.
   .

5. Haga clic en Siguiente y, después, en la página Seleccionar características, vuelva a hacer clic en Siguiente.

6. En la página Confirmar selecciones de instalación, haga clic en Instalar.

7. En la página Resultados , haga clic en Cerrar.

Windows 8 o Windows 8.1

1. En la pantalla Inicio, mueva el puntero hasta la esquina inferior izquierda, haga clic con el botón derecho en el botón Inicio y, a continuación, haga clic en Panel de control.

2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.

3. Expanda Internet Information Services y, después, seleccione Servidor FTP.

   Nota:

   Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
   

4. Haga clic en OK.

5. Haga clic en Cerrar.

Windows Server 2008 R2

1. En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, luego, haga clic en Administrador del servidor.

2. En el panel de jerarquía del Administrador del servidor, expanda Roles y, luego, haga clic en Servidor web (IIS).

3. En el panel Servidor web (IIS), desplácese hasta la sección Servicios de rol y, luego, haga clic en Agregar servicios de rol.

4. En la página Seleccionar servicios de rol del Asistente para agregar servicios de rol, expanda Servidor FTP.

5. Seleccione Servicio FTP.

   Nota:

   Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
   

6. Haga clic en Next.

7. En la página Confirmar selecciones de instalación, haz clic en Instalar.

8. En la página Resultados , haga clic en Cerrar.

Windows 7

1. En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.

2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.

3. Expanda Internet Information Services y, luego, Servidor FTP.

4. Seleccione Servicio FTP.

   Nota:

   Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
   

5. Haga clic en OK.

Windows Server 2008 o Windows Vista

1. Descargue el paquete de instalación desde la siguiente dirección URL:

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

2. Siga las instrucciones del siguiente tutorial para instalar el servicio FTP:

   • Instalación y solución de problemas de FTP 7

Procedimientos

Configuración del registro de nivel de sitio o de nivel de servidor para el servicio FTP

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 o Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).

   • Si usa Windows 8 o Windows 8.1:

     • Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
     • En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Server 2008 o Windows Server 2008 R2:

     • En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Vista o Windows 7:

     • En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
     • Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, haga clic en el nombre del servidor.

3. En el panel Inicio, haga doble clic en la característica Registro FTP.
   

4. En la lista desplegable Un archivo de registro por, elija una de las siguientes opciones:

   • Elija Sitio para especificar que cada sitio FTP escriba en archivos de registro individuales.
   • Elija Servidor para especificar un único archivo de registro para todos los sitios FTP.
     

5. En el panel Acciones, haga clic en Aplicar.

Configuración

El elemento <centralLogFile> se configura en el nivel global en ApplicationHost.config.

Atributo	Descripción
directory	Atributo de cadena opcional. Especifica el directorio de registro, donde se almacenan los archivos de soporte técnico relacionados con el registro y el archivo de registro. El valor predeterminado es %SystemDrive%\inetpub\logs\LogFiles.
enabled	Atributo Boolean opcional. true si el registro está habilitado; de lo contrario, false. El valor predeterminado es true.
localTimeRollover	Atributo Boolean opcional. true si se crea un nuevo archivo de registro en función de la hora local; de lo contrario, false para la hora universal coordinada (UTC), que anteriormente se llamaba Hora media de Greenwich (GMT). Nota: Independientemente de la configuración, la marca de tiempo de cada registro de registro extendido de W3C se basa en UTC. El valor predeterminado es false.
logExtFileFlags	Atributo flags opcional. Especifica las categorías de información escritas en el archivo de registro (cuando se usa el formato de archivo de registro extendido W3C) o en el origen de datos ODBC durante los eventos de registro de un sitio. El atributo logExtFileFlags puede ser uno o varios de los valores siguientes. Si especifica más de un valor, sepárelos con una coma (,). Los valores predeterminados son Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, FtpStatus, Win32Status, FtpSubStatus, ServerPort, Session y FullPath. Valor Descripción BytesRecv Registrar el número de bytes que el servidor recibió. El valor numérico es 8192. BytesSent Registrar el número de bytes que envió el servidor. El valor numérico es 4096. ClientIP Registrar la dirección IP del cliente que realizó la solicitud. El valor numérico es 4. ClientPort Registrar el puerto del cliente que realizó la solicitud. El valor numérico es 33554432. ComputerName Registrar el nombre del servidor en el que se generó la entrada del archivo de registro. El valor numérico es 32. Date Registrar la fecha en la que se produjo la actividad. El valor numérico es 1. FtpStatus Registrar el código de estado de FTP. El valor numérico es 1024. FtpSubStatus Registrar el código de subestado del error FTP. El valor numérico es 2097152. FullPath Registrar la ruta de acceso relativa completa. Nota: Puede ser diferente del URI que el cliente solicitó, que se registra estableciendo la marca UriStem. El valor numérico es 8388608. Host Registrar el nombre de host virtual, si hay uno. El valor numérico es 1048576. Info Registrar la información de depuración extendida, si hay alguna. El valor numérico es 16777216. Method Registrar la acción solicitada. Por ejemplo, USER, PASS, etc. El valor numérico es 128. ServerIP Registrar la dirección IP del servidor en el que se generó la entrada del archivo de registro. El valor numérico es 64. ServerPort Registrar el número de puerto del servidor configurado para el sitio. El valor numérico es 32768. Session Registrar el identificador único de la sesión FTP. Esto resulta útil para analizar la actividad de sesión en los registros. El valor numérico es 4194304. SiteName Registrar el nombre del servicio Internet y el número de instancia del sitio. El valor numérico es 16. Time Registrar la hora en hora universal coordinada (UTC), en la que se produjo la actividad. El valor numérico es 2. TimeTaken Registrar el período de tiempo necesario para que se complete una solicitud. El tiempo necesario se registra en milisegundos. El valor numérico es 16384. UriStem Registrar la información principal del identificador de recursos universal (URI), que es el destino de la acción. Nota: Esto muestra el recurso URI exactamente como lo solicitó el cliente, que puede no ser la ruta de acceso relativa completa. Para la ruta de acceso relativa completa, use la marca FullPath. El valor numérico es 256. UserName Registrar el nombre del usuario autenticado al que obtuvo acceso al servidor. Los usuarios anónimos se indican con un guion. El valor numérico es 8. Win32Status Registrar el código de estado de Windows. El valor numérico es 2048.
period	Atributo enum opcional. Especifica la frecuencia con la que el servicio FTP crea un nuevo archivo de registro. El atributo period puede ser uno de los siguientes valores posibles. El valor predeterminado es Daily. Valor Descripción Daily Crear un nuevo archivo de registro diariamente. El valor numérico es 1. Hourly Crear un nuevo archivo de registro cada hora. El valor numérico es 4. MaxSize Crear un nuevo archivo de registro cuando se alcance un tamaño máximo. El tamaño máximo se especifica en el atributo truncateSize. El valor numérico es 0. Monthly Crear un nuevo archivo de registro mensualmente. El valor numérico es 3. Weekly Crear un nuevo archivo de registro semanalmente. El valor numérico es 2.
selectiveLogging	Atributo flags opcional. Especifica el nivel de detalle del registro FTP. El valor predeterminado es LogSuccessful,LogError,LogInfrastructure. Valor Descripción LogError Especifica que se registrarán los errores. La cantidad de datos registrados realmente también depende de la configuración de la marca LogInfrastructure. El valor numérico es 2. LogInfrastructure Especifica que se registrarán todos los comandos FTP y la actividad del canal de datos de bajo nivel. Por ejemplo, si se establece la marca LogInfrastructure, los registros contendrán entradas para DataChannelOpened, DataChannelClosed, PORT/EPRT y PASV/EPSV. El valor numérico es 4. LogSuccessful Especifica que se registrará la actividad correcta. La cantidad de datos registrados realmente también depende de la configuración de la marca LogInfrastructure. El valor numérico es 1.
truncateSize	Atributo int64 opcional. Especifica el tamaño máximo del archivo de registro (en bytes) después del cual se va a crear un nuevo archivo de registro. Este valor solo es aplicable cuando MaxSize se elige para el atributo period. El tamaño mínimo de archivo es 1 048 576 bytes. Si este atributo se establece en un valor inferior a 1 048 576 bytes, se supone de forma implícita que el valor predeterminado es 1 048 576 bytes. El valor predeterminado es 20971520.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo de configuración siguiente se habilita el registro de archivos central para el servicio FTP.

<system.ftpServer>
   <log centralLogFileMode="Central">
      <centralLogFile enabled="true" />
   </log>
</system.ftpServer>

Código de ejemplo

En los ejemplos siguientes se habilita el registro de archivos central para el servicio 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

Nota:

Debe asegurarse de establecer el parámetrocommit en apphost cuando use AppCmd.exe para configurar estos valores. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo 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()