Virtual Directory <virtualDirectory>
Vue d’ensemble
L’élément <virtualDirectory> est un enfant de l’élément <application> et contrôle les paramètres de configuration d’un répertoire virtuel spécifique. Un répertoire virtuel est un nom de répertoire (également appelé chemin d'accès) que vous spécifiez dans Internet Information Services (IIS) 7 et mappé à un répertoire physique sur un serveur local ou distant. Le nom du répertoire virtuel fait ensuite partie de l'URL de l'application, et les utilisateurs peuvent demander l'URL à partir d'un navigateur pour accéder au contenu dans le répertoire physique,qui peut être une page Web ou une liste de répertoires et de fichiers supplémentaires. Si vous spécifiez un nom différent que celui du répertoire physique pour le répertoire virtuel, il est plus difficile pour les utilisateurs de découvrir la structure physique réelle des fichiers sur votre serveur, car l'URL ne se mappe pas directement à la racine du site.
Dans IIS 7, chaque application doit avoir un répertoire virtuel appelé répertoire virtuel racine, qui mappe l'application au répertoire physique qui contient le contenu de l'application. Toutefois, une application peut avoir plusieurs répertoires virtuels. Par exemple, vous pouvez utiliser un répertoire virtuel lorsque vous souhaitez que votre application inclue des images d'un autre emplacement dans le système de fichiers, mais vous ne souhaitez pas déplacer les fichiers images dans le répertoire physique mappé au répertoire virtuel racine de l'application.
Compatibilité
| Version | Notes |
|---|---|
| IIS 10.0 | L’élément <virtualDirectory> n’a fait l’objet d’aucune modification dans IIS 10.0. |
| IIS 8.5 | L’élément <virtualDirectory> n’a fait l’objet d’aucune modification dans IIS 8.5. |
| IIS 8.0 | L’élément <virtualDirectory> n’a fait l’objet d’aucune modification dans IIS 8.0. |
| IIS 7.5 | L’élément <virtualDirectory> n’a fait l’objet d’aucune modification dans IIS 7.5. |
| IIS 7.0 | L’élément <virtualDirectory> a été introduit dans IIS 7.0. |
| IIS 6.0 | L’élément <virtualDirectory> remplace les objets métabase IIS 6.0 IIsWebVirtualDir et IIsWebDirectory. |
Programme d’installation
L’élément <virtualDirectory> est inclus dans l’installation par défaut d’IIS 7.
Procédure
Comment créer un nouveau répertoire virtuel
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).
Dans le volet Connexions, développez le nom du serveur, développez Sites, développez le site Web auquel vous souhaitez ajouter le répertoire virtuel puis cliquez sur l’application à laquelle vous souhaitez ajouter le répertoire virtuel.
Dans le volet Actions, cliquez sur Afficher les répertoires virtuels, puis sur Ajouter un répertoire virtuel...
Dans la boîte de dialogue Ajouter un répertoire virtuel, entrez au minimum des informations dans l’alias : etChemin physique : zones de texte puis cliquez sur OK.
Remarque
Vous pouvez cliquer sur Se connecter en tant que... pour configurer le serveur pour utiliser les informations d’identification spécifiées lorsqu’il accède au contenu dans le répertoire virtuel, puis cliquer sur Paramètres de test... pour tester les paramètres d’authentification et d’autorisation pour le répertoire virtuel.
Configuration
L’élément <virtualDirectory> est configurable au niveau du serveur, du site et de l’application dans le fichier ApplicationHost.config.
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 pour le répertoire virtuel. 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 d’accès virtuel du répertoire virtuel. |
||||||||||
physicalPath |
Attribut de chaîne facultatif. Spécifie le chemin d’accès physique du répertoire virtuel. |
||||||||||
userName |
Attribut de chaîne facultatif. Spécifie le nom d’utilisateur d’un compte qui peut accéder aux fichiers de configuration et au contenu de ce répertoire virtuel. |
Éléments enfants
Aucune.
Exemple Configuration
L’exemple de configuration suivant affiche un <site> élément qui contient deux applications. Le premier <application> élément définit l’application racine du site ainsi que le répertoire virtuel racine de l’application. Le deuxième <application> élément contient les paramètres de configuration d’une application CRM sur le site Web. L’attribut de chemin définit le chemin d’accès de l’application. Cet <application> élément contient deux <virtualDirectory> éléments. Le premier définit le répertoire virtuel racine de l’application et le second définit un répertoire virtuel Images pour l’application.
<site name="Contoso" id="2" serverAutoStart="true">
<application path="/">
<virtualDirectory path="/" physicalPath="C:\Contoso\Content" />
</application>
<application path="/CRM">
<virtualDirectory path="/" physicalPath="C:\Contoso\Content\CRM" />
<virtualDirectory path="/Images" physicalPath="E:\Images" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:80:www.contoso.com" />
</bindings>
</site>
Exemple de code
Les exemples suivants créent une application nommée ShoppingCart avec une racine de répertoire virtuel de C :\Inetpub\Contoso\ShoppingCart pour un site nommé Contoso.
Remarque
Lorsque vous créez une application à partir de l’invite de commandes ou à partir d’un script, vous devez créer explicitement un répertoire virtuel racine pour l’application.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].[path='/ShoppingCart']" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].[path='/ShoppingCart'].[path='/',physicalPath='C:\Inetpub\Contoso\ShoppingCart']" /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");
ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");
if (siteElement == null) throw new InvalidOperationException("Element not found!");
ConfigurationElementCollection siteCollection = siteElement.GetCollection();
ConfigurationElement applicationElement = siteCollection.CreateElement("application");
applicationElement["path"] = @"/ShoppingCart";
ConfigurationElementCollection applicationCollection = applicationElement.GetCollection();
ConfigurationElement virtualDirectoryElement = applicationCollection.CreateElement("virtualDirectory");
virtualDirectoryElement["path"] = @"/";
virtualDirectoryElement["physicalPath"] = @"C:\Inetpub\Contoso\ShoppingCart";
applicationCollection.Add(virtualDirectoryElement);
siteCollection.Add(applicationElement);
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", "Contoso")
If (siteElement Is Nothing) Then
Throw New InvalidOperationException("Element not found!")
End If
Dim siteCollection As ConfigurationElementCollection = siteElement.GetCollection
Dim applicationElement As ConfigurationElement = siteCollection.CreateElement("application")
applicationElement("path") = "/ShoppingCart"
Dim applicationCollection As ConfigurationElementCollection = applicationElement.GetCollection
Dim virtualDirectoryElement As ConfigurationElement = applicationCollection.CreateElement("virtualDirectory")
virtualDirectoryElement("path") = "/"
virtualDirectoryElement("physicalPath") = "C:\Inetpub\Contoso\ShoppingCart"
applicationCollection.Add(virtualDirectoryElement)
siteCollection.Add(applicationElement)
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", "Contoso"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);
var siteCollection = siteElement.Collection;
var applicationElement = siteCollection.CreateNewElement("application");
applicationElement.Properties.Item("path").Value = "/ShoppingCart";
var applicationCollection = applicationElement.Collection;
var virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory");
virtualDirectoryElement.Properties.Item("path").Value = "/";
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\\Inetpub\\Contoso\\ShoppingCart";
applicationCollection.AddElement(virtualDirectoryElement);
siteCollection.AddElement(applicationElement);
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 = 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", "Contoso"))
If (siteElementPos = -1) Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)
Set siteCollection = siteElement.Collection
Set applicationElement = siteCollection.CreateNewElement("application")
applicationElement.Properties.Item("path").Value = "/ShoppingCart"
Set applicationCollection = applicationElement.Collection
Set virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory")
virtualDirectoryElement.Properties.Item("path").Value = "/"
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\Inetpub\Contoso\ShoppingCart"
applicationCollection.AddElement(virtualDirectoryElement)
siteCollection.AddElement(applicationElement)
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