Partager via

Valeurs par défaut du répertoire virtuel pour tous les sites <virtualDirectoryDefaults>

  • Article

Vue d’ensemble

L'élément <virtualDirectoryDefaults> de l'élément <sites> spécifie les paramètres par défaut pour tous les répertoires virtuels du serveur. L'élément <virtualDirectoryDefaults> est utile pour définir les attributs communs que vous souhaitez que tous les répertoires virtuels de votre serveur partagent implicitement lorsqu'ils ne disposent pas d'attributs explicitement définis.

Remarque

Si le même attribut ou élément enfant est configuré à la fois dans la section <virtualDirectoryDefaults> et dans la section <virtualDirectory> d'un répertoire virtuel spécifique, la configuration de la section <virtualDirectory> est utilisée pour ce répertoire virtuel.

Compatibilité

Version Notes
IIS 10.0 L'élément <virtualDirectoryDefaults> n'a pas été modifié dans IIS 10.0.
IIS 8.5 L'élément <virtualDirectoryDefaults> n'a pas été modifié dans IIS 8.5.
IIS 8.0 L'élément <virtualDirectoryDefaults> n'a pas été modifié dans IIS 8.0.
IIS 7.5 L'élément <virtualDirectoryDefaults> n'a pas été modifié dans IIS 7.5.
IIS 7.0 L'élément <virtualDirectoryDefaults> de l'élément <sites> a été introduit dans IIS 7.0.
IIS 6.0 S/O

Programme d’installation

L'élément <virtualDirectoryDefaults> de l'élément <sites> est inclus dans l'installation par défaut d'IIS 7.

Procédure

Comment configurer les informations d'identification de répertoire virtuel par défaut pour un serveur

  1. Ouvrez le Gestionnaire d'Internet Information Services (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 d'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 Internet Information Services (IIS).

  2. Dans le volet Connexions, développez le nom du serveur, puis cliquez sur le nœud Sites .

  3. Dans le volet Sites du serveur, cliquez sur Définir les valeurs par défaut du site web... dans le volet Actions.
    Screenshot that shows the Internet Information Services Manager pane. Connections is highlighted to Sites.

  4. Dans la boîte de dialogue Paramètres par défaut du site web, spécifiez vos informations d'identification de répertoire virtuel par défaut pour tous les sites web, puis cliquez sur OK.
    Screenshot that shows the Web Site Defaults. Application Pool is highlighted.

Configuration

Attributs

Attribut Description
allowSubDirConfig Attribut booléen facultatif.

Spécifie si IIS recherche les fichiers Web.config dans les répertoires de contenu situés plus bas dans la hiérarchie des répertoires que le niveau actuel (vrai) ou s'il ne recherche pas les fichiers Web.config dans les répertoires de contenu situés plus bas que le niveau actuel (faux).

La valeur par défaut est true.
logonMethod Attribut d'énumération facultatif.

Spécifie la méthode de connexion par défaut pour tous les répertoires virtuels du serveur.

L'attribut logonMethod peut être l'une des valeurs possibles suivantes. Par défaut, il s’agit de ClearText.
Valeur Description
Batch Ce type de connexion est destiné aux serveurs de traitement, où des processus peuvent être exécutés pour le compte d'un utilisateur sans que celui-ci n'intervienne directement.

La valeur numérique est 1.
ClearText Ce type de connexion conserve le nom et le mot de passe dans le package d'authentification. Cette conservation des informations d'identification permet au serveur d'établir des connexions avec d'autres serveurs du réseau tout en se faisant passer pour le client.

La valeur numérique est 3.
Interactive Ce type de connexion est destiné aux utilisateurs qui utiliseront l'ordinateur de manière interactive.

La valeur numérique est 0.
Network Ce type de connexion est destiné aux serveurs hautes performances pour authentifier les mots de passe en texte clair. Les informations d'identification ne sont pas mises en cache pour ce type de connexion.

La valeur numérique est 2.
Pour plus d'informations sur ces valeurs, consultez LogonUser.
password Attribut de chaîne facultatif.

Spécifie le mot de passe associé au nom d'utilisateur.

Remarque :  Pour éviter de stocker des chaînes de mot de passe non chiffrées dans des fichiers de configuration, utilisez toujours AppCmd.exe ou le Gestionnaire IIS pour entrer des mots de passe. Si vous utilisez ces outils de gestion, les chaînes de mot de passe sont chiffrées automatiquement avant d'être écrites dans les fichiers de configuration XML. Cette méthode offre une meilleure sécurité de mot de passe comparé au stockage de mots de passe non chiffrés.
path Attribut de chaîne facultatif.

Spécifie le chemin d'accès virtuel par défaut de tous les répertoires virtuels sur le serveur.
physicalPath Attribut de chaîne facultatif.

Spécifie le chemin d'accès physique par défaut de tous les répertoires virtuels sur le serveur.
userName Attribut de chaîne facultatif.

Spécifie le nom d'utilisateur par défaut d'un compte qui peut accéder aux fichiers de configuration et au contenu de tous les répertoires virtuels sur le serveur.

Éléments enfants

Aucune.

Exemple Configuration

L'exemple de configuration suivant spécifie la méthode de connexion par défaut pour les répertoires virtuels sur le serveur.

<sites>
   <virtualDirectoryDefaults logonMethod="Network" />
</sites>

Exemple de code

Les exemples de code suivants spécifient la méthode de connexion par défaut pour les répertoires virtuels sur le serveur.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /virtualDirectoryDefaults.logonMethod:"Network" /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 sitesSection = config.GetSection("system.applicationHost/sites");

         ConfigurationElement virtualDirectoryDefaultsElement = sitesSection.GetChildElement("virtualDirectoryDefaults");
         virtualDirectoryDefaultsElement["logonMethod"] = @"Network";

         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 virtualDirectoryDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("virtualDirectoryDefaults")
      virtualDirectoryDefaultsElement("logonMethod") = "Network"

      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 virtualDirectoryDefaultsElement = sitesSection.ChildElements.Item("virtualDirectoryDefaults");
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network";

adminManager.CommitChanges();

VBScript

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

Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set virtualDirectoryDefaultsElement = sitesSection.ChildElements.Item("virtualDirectoryDefaults")
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network"

adminManager.CommitChanges()