VirtualDirectoryElementDefaults 类 1

公开 IIS 虚拟目录的默认配置设置。

语法

class VirtualDirectoryElementDefaults : EmbeddedObject  

方法

此类不包含任何方法。

属性

下表列出了 VirtualDirectoryElementDefaults 类公开的属性。

名称	描述
AllowSubDirConfig	一个读/写 boolean 值。 如果默认情况下 IIS 在低于当前级别的内容目录中查找 Web.config 文件，则为 true；如果 IIS 不在低于当前级别的目录中查找这些文件，则为 false。
LogonMethod	一个读/写 sint32 枚举，指定用户本地登录的默认方法。 登录类型将确定是否可以远程使用生成的令牌。 后文的“备注”部分列出了可能的值。
Password	一个读/写 string 值，指定用于访问虚拟根目录的默认加密密码。 默认为 null。
Path	一个包含默认虚拟目录路径的读/写 string 值。
PhysicalPath	一个读/写 string 值，指定与虚拟目录关联的默认物理路径。
UserName	一个读/写 string 值，指定有权访问虚拟目录中任何配置文件或内容的默认用户。 默认为 null。

子类

此类不包含子类。

注解

此类的实例包含在 Server、Site 和 Application 类的 VirtualDirectoryDefaults 属性中。

下表列出了 LogonMethod 属性的可能值和关键字。 默认值为 3 (ClearText)。 有关详细信息，请参阅 LogonUserEx 函数。

值	关键字	说明
0	交互	使用户能够通过终端服务器、远程 shell 或类似进程以交互方式登录。 由于此登录类型会缓存断开连接的操作的登录信息，因此性能可能会受到影响。 因此，此登录类型不适合邮件服务器之类的客户端/服务器应用程序。
1	批处理	使用户能够通过批处理服务器登录，无需用户干预即可为用户执行进程。 此登录类型适用于一次处理许多纯文本身份验证尝试的服务器，例如邮件或 Web 服务器。 不会缓存此登录类型的凭据。
2	网络	使用户能够通过对纯文本密码进行身份验证的高性能服务器进行登录。 不会缓存此登录类型的凭据。
3	ClearText	允许用户使用基本身份验证登录。 用户的名称和密码保存在身份验证包中，从而允许服务器在模拟客户端时与其他网络服务器建立连接。 身份验证包是一个用于封装身份验证逻辑的 DLL，该逻辑确定是否允许用户登录。 本地安全机构 (LSA) 通过将请求发送到身份验证包来对用户登录进行身份验证。 然后，身份验证包检查登录信息并验证或拒绝用户登录尝试。

示例

以下示例演示如何为网站上的所有虚拟目录设置用户名和密码。 然后，演示如何检索站点的所有虚拟目录默认值。

' 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  
  

继承层次结构

EmbeddedObject

VirtualDirectoryElementDefaults

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上）
服务器	- IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上）
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

Application 类
EmbeddedObject 类
Server 类
Site 类
VirtualDirectory 类
LogonUserEx