VirtualDirectoryElementDefaults Class1

Expone los valores de configuración predeterminados para los directorios virtuales de IIS.

Sintaxis

class VirtualDirectoryElementDefaults : EmbeddedObject  

Métodos

Esta clase no contiene métodos.

Propiedades

La siguiente tabla muestra las propiedades expuestas por la clase VirtualDirectoryElementDefaults.

Nombre	Descripción
AllowSubDirConfig	Valor boolean de lectura y escritura. true si, de forma predeterminada, IIS busca archivos Web.config en directorios de contenido inferiores al nivel actual; false si IIS no busca estos archivos en directorios inferiores al nivel actual.
LogonMethod	Enumeración de lectura y escritura sint32 que especifica el método predeterminado por el que un usuario ha iniciado sesión localmente. El tipo de inicio de sesión determinará si el token resultante también se puede usar de forma remota. Los valores posibles se enumeran más adelante en la sección Comentarios.
Password	Valor de lectura y escritura string que especifica la contraseña cifrada predeterminada para el acceso al directorio raíz virtual. El valor predeterminado es null.
Path	Valor de lectura y escritura string que contiene la ruta de acceso de directorio virtual predeterminada.
PhysicalPath	Valor de lectura y escritura string que especifica la ruta de acceso física predeterminada asociada al directorio virtual.
UserName	Valor de lectura y escritura string que especifica un usuario predeterminado que tiene derechos de acceso a cualquier archivo de configuración o contenido de un directorio virtual. El valor predeterminado es null.

Subclases

Esta clase no contiene subclases.

Comentarios

Las instancias de esta clase están contenidas en la propiedad VirtualDirectoryDefaults de las clases Server, Site y Application.

La tabla siguiente contiene los valores y palabras clave posibles para la propiedad LogonMethod. El valor predeterminado es 3 (ClearText). Para obtener más información, consulte la función LogonUserEx

Valor	Palabra clave	Descripción
0	Interactivo	Permite al usuario iniciar sesión de forma interactiva a través de un servidor de terminal, un shell remoto o un proceso similar. Dado que este tipo de inicio de sesión almacena en caché la información de inicio de sesión para las operaciones desconectadas, el rendimiento puede verse afectado. Este tipo de inicio de sesión es, por lo tanto, inadecuado para las aplicaciones cliente/servidor, como los servidores de correo.
1	Batch	Permite al usuario iniciar sesión a través de un servidor por lotes, donde los procesos se pueden ejecutar para el usuario sin la intervención del usuario. Este tipo de inicio de sesión es adecuado para servidores, como correo o servidores web, que procesan muchos intentos de autenticación de texto no cifrado a la vez. Las credenciales no se almacenan en caché para este tipo de inicio de sesión.
2	Red	Permite al usuario iniciar sesión a través de un servidor de alto rendimiento que autentica contraseñas de texto no cifrado. Las credenciales no se almacenan en caché para este tipo de inicio de sesión.
3	ClearText	Permite al usuario iniciar sesión mediante la autenticación básica. El nombre y la contraseña del usuario se conservan en un paquete de autenticación, lo que permite al servidor realizar conexiones a otros servidores de red al suplantar al cliente. Un paquete de autenticación es un archivo DLL que encapsula la lógica de autenticación que determina si se permite que un usuario inicie sesión. La autoridad de seguridad local (LSA) autentica un inicio de sesión de usuario mediante el envío de la solicitud a un paquete de autenticación. A continuación, el paquete de autenticación examina la información de inicio de sesión y autentica o rechaza el intento de inicio de sesión del usuario.

Ejemplo

En el ejemplo siguiente se muestra cómo establecer el nombre de usuario y la contraseña de todos los directorios virtuales de un sitio web. A continuación, muestra cómo recuperar todos los valores predeterminados del directorio virtual para el sitio.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
  
' Set the virtual directory defaults on the Web site.  
oSite.VirtualDirectoryDefaults.UserName = "JohnV"  
oSite.VirtualDirectoryDefaults.Password = "p@ssw0rd."  
oSite.Put_  
  
' List all the virtual directory defaults for the Web site.  
WScript.Echo "AllowSubDirConfig: " & _  
    oSite.VirtualDirectoryDefaults.AllowSubDirConfig  
WScript.Echo "LogonMethod: " & _  
    GetLogonMethodText(oSite.VirtualDirectoryDefaults.LogonMethod)  
WScript.Echo "Password: " & oSite.VirtualDirectoryDefaults.Password  
WScript.Echo "Path: " & oSite.VirtualDirectoryDefaults.Path  
WScript.Echo "PhysicalPath: " & _  
    oSite.VirtualDirectoryDefaults.PhysicalPath  
WScript.Echo "UserName: " & oSite.VirtualDirectoryDefaults.UserName  
  
' This helper function converts the LogonMethod value to text.  
Function GetLogonMethodText(LogonMethodValue)  
    Select Case LogonMethodValue  
        Case 0  
            GetLogonMethodText = "Interactive"  
        Case 1  
            GetLogonMethodText = "Batch"  
        Case 2  
            GetLogonMethodText = "Network"  
        Case 3  
            GetLogonMethodText = "ClearText"  
        Case Else  
            GetLogonMethodText = "Unknown logon method."  
    End Select  
End Function  
  

Jerarquía de herencia

EmbeddedObject

VirtualDirectoryElementDefaults

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Server	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF	WebAdministration.mof

Consulte también

Application Class
EmbeddedObject Class
Server Class
Clase de sitio
VirtualDirectory Class
LogonUserEx