Opções de registro em log FTP <log>

Visão geral

O elemento <system.ftpServer/log> especifica as configurações globais de log para o serviço FTP. Mais especificamente, os atributos no elemento <system.ftpServer/log> especificam as seguintes opções:

• centralLogFileMode - Esse atributo especifica se o serviço FTP deve usar log central (por servidor) ou log de site (por site).

  • Se você especificar o registro em log central, um único arquivo de log será mantido para todos os seus sites FTP.
  • Se você especificar o registro em log do site, cada site FTP gravará em arquivos de log individuais.

• logInUTF8 - Esse atributo especifica que os arquivos de log devem ser codificados no formato UTF8.

Ao especificar o registro em log central, você pode usar o elemento filho <centralLogFile> para configurar as opções para o arquivo de log central.

Compatibilidade

Versão	Observações
IIS 10.0	O elemento <log> não foi modificado no IIS 10.0.
IIS 8.5	O elemento <log> não foi modificado no IIS 8.5.
IIS 8.0	O elemento <log> não foi modificado no IIS 8.0.
IIS 7.5	O elemento <log> do elemento <system.ftpServer> é fornecido como um recurso do IIS 7.5.
IIS 7.0	O elemento <log> do elemento <system.ftpServer> foi introduzido no FTP 7.0, que foi um download separado para o IIS 7.0.
IIS 6,0	O elemento <system.ftpServer> e seus elementos filho substituem as configurações de FTP do IIS 6.0 que estavam localizadas no caminho de metabase LM/MSFTPSVC.

Observação

Os serviços FTP 7.0 e FTP 7.5 enviados fora de banda para o IIS 7.0, o que exigia o download e a instalação de módulos do seguinte URL:

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

Com o Windows 7 e o Windows Server 2008 R2, o serviço FTP 7.5 é fornecido como um recurso para o IIS 7.5, portanto, o download do serviço FTP não é mais necessário.

Instalação

Para dar suporte à publicação FTP para seu servidor Web, você deve instalar o serviço FTP. Para fazer isso, execute as etapas a seguir.

Windows Server 2012 R2 ou Windows Server 2012

1. Na barra de tarefas, clique em Gerenciador do Servidor.

2. No Gerenciador do Servidor, clique no menu Gerenciar e clique em Adicionar Funções e Recursos.

3. No assistente Adicionar Funções e Recursos, clique em Avançar. Selecione o tipo de instalação e clique em Avançar. Selecione o servidor de destino e clique em Avançar.

4. Na página Funções do Servidor, expanda Servidor Web (IIS) e selecione Servidor FTP.

   Observação

   Para dar suporte à autenticação do ASP.Membership ou do Gerenciador do IIS para o serviço FTP, você precisará selecionar a Extensibilidade de FTP além do Serviço FTP.
   .

5. Clique em Próximo e, na página Selecionar recursos, clique em Próximo novamente.

6. Na página Confirmar seleções de instalação, clique em Instalar.

7. Na página Resultados , clique em Fechar.

Windows 8 ou Windows 8.1

1. Na tela Iniciar, mova o ponteiro até o canto inferior esquerdo, clique com o botão direito do mouse no botão Iniciar e clique em Painel de Controle.

2. Em Painel de Controle, clique em Programas e Recursos e clique em Ativar ou desativar recursos do Windows.

3. Expanda Serviços de Informações da Internet e, em seguida, selecione Servidor FTP.

   Observação

   Para dar suporte à autenticação do ASP.Membership ou do Gerenciador do IIS para o serviço FTP, você também precisará selecionar a Extensibilidade de FTP.
   

4. Clique em OK.

5. Clique em Fechar.

Windows Server 2008 R2

1. Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador do Servidor.

2. No painel de hierarquia do Gerenciador do Servidor, expanda Funções e clique em Servidor Web (IIS).

3. No painel Servidor Web (IIS), role até a seção Serviços de Função e clique em Adicionar Serviços de Função.

4. Na página Selecionar Serviços de Função do Assistente para Adicionar Serviços de Função, expanda Servidor FTP.

5. Selecione Serviço FTP.

   Observação

   Para dar suporte à autenticação do ASP.Membership ou do Gerenciador do IIS para o serviço FTP, você também precisará selecionar a Extensibilidade de FTP.
   

6. Clique em Avançar.

7. Na página Confirmar Seleções de Instalação, clique em Instalar.

8. Na página Resultados , clique em Fechar.

Windows 7

1. Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.

2. Em Painel de Controle, clique em Programas e Recursos e clique em Ativar ou desativar Recursos do Windows.

3. Expanda Serviços de Informações da Internet e, em seguida, Servidor FTP.

4. Selecione Serviço FTP.

   Observação

   Para dar suporte à autenticação do ASP.Membership ou do Gerenciador do IIS para o serviço FTP, você também precisará selecionar a Extensibilidade de FTP.
   

5. Clique em OK.

Windows Server 2008 ou Windows Vista

1. Baixe o pacote de instalação da seguinte URL:

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

2. Siga as instruções no seguinte passo a passo para instalar o serviço FTP:

   • Instalar e solucionar problemas do FTP 7

Instruções

Como configurar o registro em log no nível do site ou no nível do servidor para o serviço FTP

1. Abra o Gerenciador dos Serviços de Informações da Internet (IIS):

   • Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:

     • Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Se você estiver usando o Windows 8 ou Windows 8.1:

     • Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
     • Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:

     • Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador dos Serviços de Informações da Internet (IIS).

   • Se você estiver usando o Windows Vista ou Windows 7:

     • Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
     • Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

2. No painel Conexões, clique no nome do servidor.

3. No painel Página Inicial, clique duas vezes no recurso Registro em Log de FTP.
   

4. Na lista suspensa Um arquivo de log por, escolha uma das seguintes opções:

   • Escolha Site para especificar que cada site FTP gravará em arquivos de log individuais.
   • Escolha Servidor para especificar um único arquivo de log para todos os seus sites FTP.
     

5. No painel Ações, clique em Aplicar.

Configuração

O elemento <system.ftpServer/log> é configurado no nível global em ApplicationHost.config.

Atributos

Atributo	Descrição
centralLogFileMode	Atributo de enumeração opcional. Especifica se o serviço FTP deve usar log central (por servidor) ou log de site (por site). Atributo Descrição Site Especifica que cada site FTP gravará em arquivos de log individuais. O valor numérico é 0. Central Especificar que um único arquivo de log será mantido para todos os seus sites FTP. O valor numérico é 1. O valor padrão é Site.
logInUTF8	Atributo Boolean opcional. Especifica se o IIS deve registrar todas as cadeias de caracteres para o servidor FTP no UTF-8. Essa configuração se aplica ao registro em log no modo de texto para todos os sites no servidor FTP. O valor padrão é true.

Elementos filho

Elemento	Descrição
centralLogFile	Elemento opcional. Especifica as configurações do arquivo de log central.

Observação

Um elemento não utilizado chamado <customLogging> foi declarado no esquema FTP 7.0, mas ele foi removido do esquema FTP 7.5 e não deve ser usado.

Exemplo de configuração

O exemplo de configuração a seguir habilita o registro em log de arquivo central para o serviço FTP.

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

Exemplo de código

Os exemplos a seguir habilitam o registro em log de arquivo central para o serviço 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

Observação

Defina o parâmetro commit para apphost quando usar AppCmd.exe para definir essas configurações. Isso confirma as definições de configuração para a seção de local apropriado no arquivo 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()