Configuración de exploración de directorio FTP predeterminado <directoryBrowse>

Información general

El elemento <directoryBrowse> se usa para especificar la configuración de contenido para la exploración de directorios en sitios FTP. Al configurar las opciones de exploración de directorios, todos los directorios de un sitio FTP usarán la misma configuración. La configuración de exploración de directorios normalmente solo afectará a los clientes FTP de la línea de comandos, pero puede afectar a algunos clientes de FTP gráficos. Por ejemplo, un cliente FTP gráfico podría no funcionar con el estilo MS-DOS de listas de directorios, en cuyo caso tendría que configurar el estilo de lista de directorios de UNIX.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <directoryBrowse> no se modificó en IIS 10.0.
IIS 8.5	El elemento <directoryBrowse> no se modificó en IIS 8.5.
IIS 8.0	El elemento <directoryBrowse> no se modificó en IIS 8.0.
IIS 7.5	El elemento <directoryBrowse> del elemento <ftpServer> se incluye como una característica de IIS 7.5.
IIS 7.0	El elemento <directoryBrowse> del elemento <ftpServer> se introdujo en FTP 7.0, que era una descarga independiente para IIS 7.0.
IIS 6,0	N/D

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 de la exploración de directorios 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, expanda el nombre del servidor y vaya al sitio, la aplicación o el directorio donde desea configurar la exploración de directorios.

3. En el panel Inicio, haga doble clic en Examen de directorios FTP.
   

4. Configure las siguientes opciones:

   • Haga clic para seleccionar UNIX para el estilo de lista de directorios.
   • Haga clic para seleccionar Directorios virtuales.
   • Haga clic para seleccionar Bytes disponibles.
     

5. Haga clic en Aplicar en el panel Acciones.

Configuración

Atributos

Atributo	Descripción
showFlags	Atributo flags opcional. Especifica las opciones para las listas de directorios. NOMBRE Valor LongDate Especifica si se muestran fechas largas o fechas cortas. El valor numérico es 2. StyleUnix Especifica si se deben mostrar listados de directorios de estilo UNIX; De lo contrario, muestra listados de estilo MSDOS. El valor numérico es 4. DisplayAvailableBytes Especifica si se muestran los bytes disponibles en las listas de directorios. El valor numérico es 16. DisplayVirtualDirectories Especifica si se deben mostrar directorios virtuales si se establece. De lo contrario, los directorios virtuales están ocultos. El valor numérico es 32. UseGmtTime Especifica si se muestran fechas y horas en GMT. El valor numérico es 64. No existe ningún valor predeterminado.
virtualDirectoryTimeout	Atributo int opcional. Especifica la cantidad máxima de tiempo que usará el servicio FTP para recuperar la información de marca de tiempo de los directorios virtuales. Si se alcanza el umbral o virtualDirectoryTimeout se establece en 0, se usará la fecha actual en su lugar. El valor predeterminado es 5.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo de configuración siguiente se muestra un elemento <siteDefaults> de ejemplo para un servidor configurado para mostrar listados de directorios de estilo UNIX y el espacio de unidad disponible para las listas de directorios.

<siteDefaults>
   <ftpServer>
      <directoryBrowse showFlags="StyleUnix, DisplayAvailableBytes" />
   </ftpServer>
</siteDefaults>

Código de ejemplo

Los ejemplos de código siguientes configuran los valores predeterminados del sitio FTP para mostrar listados de directorios de estilo UNIX y el espacio de unidad disponible para las descripciones de directorios.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.ftpServer.directoryBrowse.showFlags:"StyleUnix, DisplayAvailableBytes" /commit:apphost

Nota:

Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. 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 sitesSection = config.GetSection("system.applicationHost/sites");
            ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");
            ConfigurationElement ftpServerElement = siteDefaultsElement.GetChildElement("ftpServer");

            ConfigurationElement directoryBrowseElement = ftpServerElement.GetChildElement("directoryBrowse");
            directoryBrowseElement["showFlags"] = @"StyleUnix, DisplayAvailableBytes";

            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 directoryBrowseElement As ConfigurationElement = ftpServerElement.GetChildElement("directoryBrowse")
        directoryBrowseElement("showFlags") = "StyleUnix, DisplayAvailableBytes"

        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 directoryBrowseElement = ftpServerElement.ChildElements.Item("directoryBrowse");
   directoryBrowseElement.Properties.Item("showFlags").Value = "StyleUnix, DisplayAvailableBytes";

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 directoryBrowseElement = ftpServerElement.ChildElements.Item("directoryBrowse")
   directoryBrowseElement.Properties.Item("showFlags").Value = "StyleUnix, DisplayAvailableBytes"

adminManager.CommitChanges()