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
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 y haga clic en el nodo Sitios.
En el panel Sitios del servidor, haga clic en Establecer valores predeterminados del sitio web... en el panel Acciones.
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.
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 .
|
||||||||||
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()