Valeurs par défaut de l’annuaire virtuel pour un site <virtualDirectoryDefaults>
Vue d’ensemble
L’élément <virtualDirectoryDefaults> de l’élément <site> spécifie les paramètres par défaut pour tous les répertoires virtuels du site parent. L’élément <virtualDirectoryDefaults> est utile pour définir les attributs communs que vous souhaitez que tous les répertoires virtuels du site parent partagent implicitement lorsqu’ils n’ont pas d’attributs définis explicitement.
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 <site> a été introduit dans IIS 7.0. |
| IIS 6.0 | S/O |
Programme d’installation
L’élément <virtualDirectoryDefaults> de l’élément <site> 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 site
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 des services Internet (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 :
- Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire des services Internet (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).
Dans le volet Connexions, développez le nom du serveur, développez le nœud Sites puis cliquez sur le nom du site.
Dans le volet Accueil du site, cliquez sur Afficher les applications dans le volet Actions.
Dans le volet Application du site, cliquez sur Définir les valeurs par défaut de l’application... dans le volet Actions.
Dans la boîte de dialogue Paramètres par défaut de l’application, spécifiez vos informations d’identification de répertoire virtuel par défaut pour le site, puis cliquez sur OK.
Configuration
Attributs
| Attribut | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
allowSubDirConfig |
Attribut booléen facultatif. Spécifie si IIS recherche des fichiers web.config dans les répertoires de contenus en dessous du niveau actuel (true) ou ne recherche pas de fichiers web.config dans les répertoires de contenus en dessous du niveau actuel (false). La valeur par défaut est true. |
||||||||||
logonMethod |
Attribut d’énumération facultatif. Spécifie la méthode d’ouverture de session par défaut pour tous les répertoires virtuels dans les applications du site parent. L’attribut logonMethod peut être l’une des valeurs possibles suivantes. Par défaut, il s’agit de ClearText.
|
||||||||||
| . | |||||||||||
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. Cela offre une meilleure sécurité de mot de passe que le stockage de mots de passe non chiffrés. |
||||||||||
path |
Attribut de chaîne facultatif. Spécifie le chemin virtuel par défaut de tous les répertoires virtuels dans les applications du site parent. |
||||||||||
physicalPath |
Attribut de chaîne facultatif. Spécifie le chemin physique par défaut de tous les répertoires virtuels dans les applications du site parent. |
||||||||||
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 dans les applications du site parent. |
Éléments enfants
Aucune.
Exemple Configuration
L’exemple de configuration suivant spécifie la méthode d’ouverture de session par défaut pour les répertoires virtuels dans le site internet par défaut.
<sites>
<site name="Default Web Site" id="1">
<application path="/">
<virtualDirectory path="/" physicalPath="C:\Inetpub\wwwroot" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:80:" />
</bindings>
<virtualDirectoryDefaults logonMethod="Network" />
</site>
</sites>
Exemple de code
Les exemples de code suivants spécifient la méthode d’ouverture de session par défaut pour les répertoires virtuels dans le site internet par défaut.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].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 à l’emplacement de la section 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");
ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Default Web Site");
if (siteElement == null) throw new InvalidOperationException("Element not found!");
ConfigurationElement virtualDirectoryDefaultsElement = siteElement.GetChildElement("virtualDirectoryDefaults");
virtualDirectoryDefaultsElement["logonMethod"] = @"Network";
serverManager.CommitChanges();
}
}
private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
{
foreach (ConfigurationElement element in collection)
{
if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
{
bool matches = true;
for (int i = 0; i < keyValues.Length; i += 2)
{
object o = element.GetAttributeValue(keyValues[i]);
string value = null;
if (o != null)
{
value = o.ToString();
}
if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
{
matches = false;
break;
}
}
if (matches)
{
return element;
}
}
}
return null;
}
}
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 sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Default Web Site")
If (siteElement Is Nothing) Then
Throw New InvalidOperationException("Element not found!")
End If
Dim virtualDirectoryDefaultsElement As ConfigurationElement = siteElement.GetChildElement("virtualDirectoryDefaults")
virtualDirectoryDefaultsElement("logonMethod") = "Network"
serverManager.CommitChanges()
End Sub
Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
For Each element As ConfigurationElement In collection
If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
Dim matches As Boolean = True
Dim i As Integer
For i = 0 To keyValues.Length - 1 Step 2
Dim o As Object = element.GetAttributeValue(keyValues(i))
Dim value As String = Nothing
If (Not (o) Is Nothing) Then
value = o.ToString
End If
If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
matches = False
Exit For
End If
Next
If matches Then
Return element
End If
End If
Next
Return Nothing
End Function
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 sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Default Web Site"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);
var virtualDirectoryDefaultsElement = siteElement.ChildElements.Item("virtualDirectoryDefaults");
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network";
adminManager.CommitChanges();
function FindElement(collection, elementTagName, valuesToMatch) {
for (var i = 0; i < collection.Count; i++) {
var element = collection.Item(i);
if (element.Name == elementTagName) {
var matches = true;
for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
var property = element.GetPropertyByName(valuesToMatch[iVal]);
var value = property.Value;
if (value != null) {
value = value.toString();
}
if (value != valuesToMatch[iVal + 1]) {
matches = false;
break;
}
}
if (matches) {
return i;
}
}
}
return -1;
}
VBScript
Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Default Web Site"))
If (siteElementPos = -1) Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)
Set virtualDirectoryDefaultsElement = siteElement.ChildElements.Item("virtualDirectoryDefaults")
virtualDirectoryDefaultsElement.Properties.Item("logonMethod").Value = "Network"
adminManager.CommitChanges()
Function FindElement(collection, elementTagName, valuesToMatch)
For i = 0 To CInt(collection.Count) - 1
Set element = collection.Item(i)
If element.Name = elementTagName Then
matches = True
For iVal = 0 To UBound(valuesToMatch) Step 2
Set property = element.GetPropertyByName(valuesToMatch(iVal))
value = property.Value
If Not IsNull(value) Then
value = CStr(value)
End If
If Not value = CStr(valuesToMatch(iVal + 1)) Then
matches = False
Exit For
End If
Next
If matches Then
Exit For
End If
End If
Next
If matches Then
FindElement = i
Else
FindElement = -1
End If
End Function