Compartir a través de


Valores predeterminados de directorio virtual para todos los sitios <virtualDirectoryDefaults>

Información general

El elemento <virtualDirectoryDefaults> del elemento <sites> especifica la configuración predeterminada para todos los directorios virtuales del servidor. El elemento <virtualDirectoryDefaults> es útil para definir los atributos comunes que desea que todos los directorios virtuales del servidor 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 <sites> se introdujo en IIS 7.0.
IIS 6,0 N/D

Configuración

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

Procedimientos

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

  1. 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).
  2. En el panel Conexiones, expanda el nombre del servidor y haga clic en el nodo Sitios.

  3. En el panel Sitios del servidor, haga clic en Establecer valores predeterminados del sitio web... en el panel Acciones.
    Screenshot that shows the Internet Information Services Manager pane. Connections is highlighted to Sites.

  4. En el cuadro de diálogo Valores predeterminados del sitio web, especifique sus credenciales de directorio virtual predeterminadas para todos los sitios web y, a continuación, haga clic en Aceptar.
    Screenshot that shows the Web Site Defaults. Application Pool is highlighted.

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 del servidor.

El atributo logonMethod puede tener 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. Esto permite que el servidor realice 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 para todos los directorios virtuales del servidor.
physicalPath Atributo de cadena opcional.

Especifica la ruta de acceso física predeterminada para todos los directorios virtuales del servidor.
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 del servidor.

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 todos los directorios virtuales del servidor.

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

Código de ejemplo

Los ejemplos de código siguientes especifican el método de inicio de sesión predeterminado para todos los directorios virtuales del servidor.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /virtualDirectoryDefaults.logonMethod:"Network" /commit:apphost

Nota:

Debe asegurarse de establecer el parámetrocommit en apphost cuando use AppCmd.exe para configurar estos valores. 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");

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