Partager via

Serveur d’exécution FTP <serverRuntime>

  • Article

Vue d’ensemble

L’élément <serverRuntime> spécifie les paramètres qui configurent le fonctionnement du service FTP. Plus précisément, l’élément <serverRuntime> contient l’élément <hostNameSupport>, qui vous permet de configurer si la syntaxe de nom de domaine peut être utilisée pour spécifier des hôtes virtuels FTP.

Les noms d’hôtes virtuels FTP ont été introduits dans FTP 7.0 et un nom d’hôte virtuel FTP est spécifié dans le cadre d’une liaison de la même façon que vous spécifiez les noms d’en-tête d’hôte HTTP. Par exemple, vous pouvez spécifier les liaisons à l’aide de noms d’hôte tels que www.contoso.com ou www.fabrikam.com pour les liaisons HTTP et ftp.contoso.com ou ftp.fabrikam.com pour les liaisons FTP. HTTP permet de transmettre le nom d’hôte dans les en-têtes passés entre le client et le serveur, mais FTP ne fournit actuellement pas cette même fonctionnalité. En raison de cette limitation FTP, le nom d’hôte virtuel est utilisé dans le cadre du nom d’utilisateur pendant le processus de connexion. Par défaut, un client FTP doit spécifier ses informations d’identification de connexion à l’aide du caractère de canal (ligne verticale) avec une syntaxe similaire à ftp.contoso.com|username ou ftp.fabrikam.com|username. En définissant l’attribut useDomainNameAsHostName sur true, vous pouvez spécifier l’hôte virtuel et le nom d’utilisateur à l’aide de la syntaxe de nom de domaine. Cela vous permet d’utiliser un caractère de barre oblique inverse au lieu du caractère de canal (ligne verticale). Ainsi, la syntaxe ressemblerait à ftp.contoso.com\username ou ftp.fabrikam.com\username.

Remarque

FTP 7.0 et FTP 7.5 prennent en charge la commande FTP HOST proposée, qui ne nécessite pas que vous utilisiez le nom d’hôte virtuel dans le cadre du nom d’utilisateur.

Compatibilité

Version Notes
IIS 10.0 L’élément <serverRuntime> n’a pas été modifié dans IIS 10.0.
IIS 8.5 L’élément <serverRuntime> n’a pas été modifié dans IIS 8.5.
IIS 8.0 L’élément <serverRuntime> n’a fait l’objet d’aucune modification dans IIS 8.0.
IIS 7.5 L’élément <serverRuntime> de l’élément <system.ftpServer> a été introduit dans FTP 7.5 et est fourni en tant que fonctionnalité d’IIS 7.5.
IIS 7.0 S/O
IIS 6.0 N/A

Remarque

Les services FTP 7.0 et FTP 7.5 ont été expédiés hors bande pour IIS 7.0, ce qui nécessite le téléchargement et l’installation du service à partir de l’URL suivante :

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

Avec Windows 7 et Windows Server 2008 R2, le service FTP 7.5 est fourni en tant que fonctionnalité pour IIS 7.5. Le téléchargement du service FTP n’est donc plus nécessaire.

Programme d’installation

Pour prendre en charge la publication FTP pour votre serveur internet, vous devez installer le service FTP. Pour cela, procédez comme suit.

Windows Server 2012 ou Windows Server 2012 R2

  1. Dans la barre des tâches, cliquez sur Gestionnaire de serveur.

  2. Dans Gestionnaire de serveur, cliquez sur le menu Gérer, puis sur Ajouter des rôles et des fonctionnalités.

  3. Dans l’Assistant Ajout de rôles et de fonctionnalités, cliquez sur Suivant. Sélectionnez le type d’installation, puis cliquez sur Suivant. Sélectionnez le serveur de destination, puis cliquez sur Suivant.

  4. Sur la page Serveur des rôles, développez Serveur internet (IIS), puis sélectionnez Serveur FTP.

    Remarque

    Pour prendre en charge l’authentification ASP.Membership ou l’authentification du Gestionnaire IIS pour le service FTP, vous devez sélectionner Extensibilité FTP en plus de Service FTP. Screenshot of the F T P Extensibility option being selected and highlighted.

  5. Cliquez sur Suivant puis sur la pageSélectionner des fonctionnalités, cliquez à nouveau sur Suivant.

  6. Dans la page Confirmer les sélections d’installation, cliquez sur Installer.

  7. Dans la page Résultats , cliquez sur Fermer.

Windows 8 ou Windows 8.1

  1. Dans l’écran d’accueil, déplacez le pointeur jusqu’au coin inférieur gauche, cliquez avec le bouton droit sur le bouton Démarrer, puis cliquez sur Panneau de configuration.

  2. Dans le Panneau de configuration, cliquez sur Programmes et fonctionnalités, puis sur Activer ou désactiver des fonctionnalités Windows.

  3. Développez Internet Information Services, puis sélectionnez Serveur FTP.

    Remarque

    Pour prendre en charge l’authentification ASP.Membership ou l’authentification du Gestionnaire IIS pour le service FTP, vous devez également sélectionner Extensibilité FTP. Screenshot of the F T P Extensibility folder being highlighted and selected.

  4. Cliquez sur OK.

  5. Cliquez sur Fermer.

Windows Server 2008 R2

  1. Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire de serveur.

  2. Dans le volet hiérarchie du Gestionnaire de serveur, développez Rôles, puis cliquez sur Serveur web (IIS).

  3. Dans le volet Serveur web (IIS), faites défiler jusqu’à la section Services de rôle, puis cliquez sur Ajouter des services de rôle.

  4. Dans la page Sélectionner des services de rôle de l’Assistant Ajouter des services de rôle, développez le Serveur FTP.

  5. Sélectionnez Service FTP.

    Remarque

    Pour prendre en charge l’authentification ASP.Membership ou l’authentification du Gestionnaire IIS pour le service FTP, vous devez également sélectionner Extensibilité FTP. Screenshot of the Select Role Services wizard showing the F T P Service option being selected and highlighted.

  6. Sélectionnez Suivant.

  7. Dans la page Confirmer les sélections pour l'installation, cliquez sur Installer.

  8. Dans la page Résultats , cliquez sur Fermer.

Windows 7

  1. Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.

  2. Dans le Panneau de configuration, cliquez sur Programmes et fonctionnalités, puis sur Activer ou désactiver des fonctionnalités Windows.

  3. Développez Services internet, puis Serveur FTP.

  4. Sélectionnez Service FTP.

    Remarque

    Pour prendre en charge l’authentification ASP.Membership ou l’authentification du Gestionnaire IIS pour le service FTP, vous devez également sélectionner Extensibilité FTP. Screenshot of the Turn Windows features on or off dialog box, showing the F T P Extensibility folder.

  5. Cliquez sur OK.

Windows Server 2008 ou Windows Vista

  1. Téléchargez le package d’installation à partir de l’URL suivante :

  2. Suivez les instructions de la procédure pas à pas suivante pour installer le service FTP :

Procédure

Comment configurer la syntaxe de nom de domaine pour les noms d’hôtes virtuels

Remarque

Il n’existe aucune interface utilisateur directe qui vous permet de configurer l’élément <hostNameSupport>. Par conséquent, les étapes suivantes utilisent la fonctionnalité Éditeur de configuration IIS.

  1. Ouvrez le Gestionnaire des services Internet (IIS) :

    • Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :

      • Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire Internet Information Services (IIS).

    • Si vous utilisez Windows 8 ou Windows 8.1 :

      • Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
      • Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).

    • Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :

      • Cliquez sur Démarrer, placez le curseur sur Outils d’administration, puis cliquez sur Gestionnaire Internet Information Services (IIS).

    • Si vous utilisez Windows Vista ou Windows 7 :

      • Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
      • Double-cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).

  2. Dans le volet Connexions, cliquez sur le nom du serveur.

  3. Dans le volet Accueil, double-cliquez sur la fonctionnalité Éditeur de configuration.

  4. Dans le menu déroulant Section, développez sytem.ftpServer, puis cliquez sur serverRuntime.

  5. Développez hostNameSupport dans l’affichage de liste.
    Screenshot of the Configuration Editor feature showing the host name support option in the Deepest Path list view.

  6. Choisissez True ou False dans la liste déroulante pour l’attribut useDomainNameAsHostName.

  7. Dans le volet Actions, cliquez sur Appliquer.

Remarque

Cette section contient des informations sur la modification de vos paramètres IIS à l’aide de l’éditeur de configuration IIS. La modification incorrecte de vos paramètres de configuration IIS peut endommager gravement votre installation IIS. Par conséquent, vérifiez que vous suivez ces étapes attentivement. Pour renforcer la sécurité, vous devez sauvegarder vos paramètres de configuration IIS avant d’utiliser l’éditeur de configuration IIS pour apporter des modifications. Pour plus d’informations sur la sauvegarde de vos paramètres de configuration IIS et sur l’utilisation de l’éditeur de configuration IIS, consultez les rubriques suivantes :

Configuration

L’élément <serverRuntime> est configuré au niveau global dans ApplicationHost.config.

Attributs

Aucune.

Éléments enfants

Élément Description
hostNameSupport Élément facultatif.

Spécifie si la syntaxe de nom de domaine pour les noms d’hôtes virtuels est autorisée.

Exemple Configuration

L’exemple suivant affiche un élément <serverRuntime> qui configure la syntaxe de nom de domaine autorisée par le serveur pour les noms d’hôtes virtuels.

<system.ftpServer>
    <serverRuntime>
        <hostNameSupport useDomainNameAsHostName="true" />
    </serverRuntime>
</system.ftpServer>

Exemple de code

Les exemples suivants configurent l’élément <serverRuntime> d’un serveur FTP pour autoriser la syntaxe de nom de domaine pour les noms d’hôtes virtuels FTP.

AppCmd.exe

appcmd.exe set config -section:system.ftpServer/serverRuntime /hostNameSupport.useDomainNameAsHostName:"True" /commit:apphost

Remarque

Vous devez veiller à définir le paramètre commit sur apphost quand vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration dans la section d’emplacement appropriée dans le fichier 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 serverRuntimeSection = config.GetSection("system.ftpServer/serverRuntime");

         ConfigurationElement hostNameSupportElement = serverRuntimeSection.GetChildElement("hostNameSupport");
         hostNameSupportElement["useDomainNameAsHostName"] = 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 serverRuntimeSection As ConfigurationSection = config.GetSection("system.ftpServer/serverRuntime")

      Dim hostNameSupportElement As ConfigurationElement = serverRuntimeSection.GetChildElement("hostNameSupport")
      hostNameSupportElement("useDomainNameAsHostName") = True

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var serverRuntimeSection = adminManager.GetAdminSection("system.ftpServer/serverRuntime", "MACHINE/WEBROOT/APPHOST");
var hostNameSupportElement = serverRuntimeSection.ChildElements.Item("hostNameSupport");
hostNameSupportElement.Properties.Item("useDomainNameAsHostName").Value = true;

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set serverRuntimeSection = adminManager.GetAdminSection("system.ftpServer/serverRuntime", "MACHINE/WEBROOT/APPHOST")
Set hostNameSupportElement = serverRuntimeSection.ChildElements.Item("hostNameSupport")
hostNameSupportElement.Properties.Item("useDomainNameAsHostName").Value = True

adminManager.CommitChanges()