Valores predeterminados de directorio virtual para <virtualDirectoryDefaults> de un sitio

Artículo
03/19/2024

Información general

El elemento <virtualDirectoryDefaults> del elemento <site> especifica la configuración predeterminada para todos los directorios virtuales del sitio primario. El elemento <virtualDirectoryDefaults> es útil para definir los atributos comunes que desea que todos los directorios virtuales del sitio primario compartan implícitamente cuando no tienen atributos definidos explícitamente.

Nota:

Si el mismo atributo o elemento secundario está configurado en la sección <virtualDirectoryDefaults> y en la sección <virtualDirectory> para un directorio virtual específico, la configuración de la sección <virtualDirectory> se usa para ese directorio virtual.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento `<virtualDirectoryDefaults>` no se modificó en IIS 10.0.
IIS 8.5	El elemento `<virtualDirectoryDefaults>` no se modificó en IIS 8.5.
IIS 8.0	El elemento `<virtualDirectoryDefaults>` no se modificó en IIS 8.0.
IIS 7.5	El elemento `<virtualDirectoryDefaults>` no se modificó en IIS 7.5.
IIS 7.0	El elemento `<virtualDirectoryDefaults>` del elemento `<site>` se introdujo en IIS 7.0.
IIS 6,0	N/D

Configuración

El elemento <virtualDirectoryDefaults> del elemento <site> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

Configuración de las credenciales de directorio virtual predeterminadas para un sitio

Abra el Administrador de Internet Information Services (IIS):
- Si usa Windows Server 2012 o Windows Server 2012 R2:
  - En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).
- Si usa Windows 8 o Windows 8.1:
  - Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
  - En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
- Si usa Windows Server 2008 o Windows Server 2008 R2:
  - En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).
- Si usa Windows Vista o Windows 7:
  - En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
  - Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
En el panel Conexiones, expanda el nombre del servidor, expanda el nodo Sitios y, a continuación, haga clic en el nombre del sitio.
En el panel Inicio del sitio, haga clic en Ver aplicaciones en el panel Acciones.
En el panel Aplicación del sitio, haga clic en Establecer valores predeterminados de la aplicación... en el panel Acciones.
En el cuadro de diálogo Valores predeterminados de la aplicación, especifique sus credenciales de directorio virtual predeterminadas para el sitio y, a continuación, haga clic en Aceptar.

Configuración

Atributos

Atributo Descripción

allowSubDirConfig Atributo Boolean opcional.

Especifica si IIS busca archivos Web.config en directorios de contenido inferiores en la jerarquía de directorios que el nivel actual (true) o no busca archivos Web.config en directorios de contenido inferiores al nivel actual (false).

El valor predeterminado es true.

logonMethod

Atributo enum opcional.

Especifica el método de inicio de sesión predeterminado para todos los directorios virtuales de las aplicaciones del sitio primario.

El atributo logonMethod puede ser uno de los siguientes valores posibles. El valor predeterminado es ClearText.

Valor	Descripción
`Batch`	Este tipo de inicio de sesión está pensado para servidores por lotes, donde los procesos se pueden ejecutar en nombre de un usuario sin su intervención directa. El valor numérico es `1`.
`ClearText`	Este tipo de inicio de sesión conserva el nombre y la contraseña en el paquete de autenticación, lo que permite al servidor realizar conexiones a otros servidores de red al suplantar al cliente. El valor numérico es `3`.
`Interactive`	Este tipo de inicio de sesión está pensado para los usuarios que van a usar interactivamente el equipo. El valor numérico es `0`.
`Network`	Este tipo de inicio de sesión está diseñado para servidores de alto rendimiento para autenticar contraseñas de texto no cifrado. Las credenciales no se almacenan en caché para este tipo de inicio de sesión. El valor numérico es `2`.

Para obtener más información sobre estos valores, vea LogonUser

password Atributo de cadena opcional.

Especifica la contraseña asociada al nombre de usuario.

Nota: Para evitar almacenar cadenas de contraseña sin cifrar en archivos de configuración, use siempre AppCmd.exe o el Administrador de IIS para escribir contraseñas. Si usa estas herramientas de administración, las cadenas de contraseña se cifrarán automáticamente antes de que se escriban en los archivos de configuración XML. Esto proporciona una mejor seguridad de contraseña que almacenar contraseñas sin cifrar.

path Atributo de cadena opcional.

Especifica la ruta de acceso virtual predeterminada de todos los directorios virtuales de las aplicaciones del sitio primario.

physicalPath Atributo de cadena opcional.

Especifica la ruta de acceso física predeterminada de todos los directorios virtuales de las aplicaciones del sitio primario.

userName Atributo de cadena opcional.

Especifica el nombre de usuario predeterminado de una cuenta que puede acceder a los archivos de configuración y el contenido de todos los directorios virtuales de las aplicaciones del sitio primario.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo de configuración siguiente se especifica el método de inicio de sesión predeterminado para los directorios virtuales del sitio web predeterminado.

<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>

Código de ejemplo

Los ejemplos de código siguientes especifican el método de inicio de sesión predeterminado para los directorios virtuales en el sitio web predeterminado.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites "/[name='Default Web Site'].virtualDirectoryDefaults.logonMethod:Network" /commit:apphost

Nota:

Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo 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

Compartir a través de

Valores predeterminados de directorio virtual para <virtualDirectoryDefaults> de un sitio

Información general

Compatibilidad

Configuración

Procedimientos

Configuración de las credenciales de directorio virtual predeterminadas para un sitio

Configuración

Atributos

Elementos secundarios

Ejemplo de configuración

Código de ejemplo

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Comentarios

Recursos adicionales