BasicAuthenticationSection 类

配置基本身份验证。

语法

class BasicAuthenticationSection : ConfigurationSection  

方法

下表列出了 BasicAuthenticationSection 类公开的方法。

名称	描述
GetAllowDefinition	（继承自 ConfigurationSection。）
GetAllowLocation	（从 ConfigurationSection 继承。）
RevertToParent	（从 ConfigurationSection 继承。）
SetAllowDefinition	（从 ConfigurationSection 继承。）
SetAllowLocation	（从 ConfigurationSection 继承。）

属性

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

名称	描述
DefaultLogonDomain	一个读/写 string 值，该值指定服务器在客户端未在登录对话框中指定域时用于对用户进行身份验证的默认域。
Enabled	一个读/写 boolean 值。 启用基本身份验证时，为 true；否则为 false。 默认为 false。
Location	（继承自 ConfigurationSection。）一个键属性。
LogonMethod	一个读/写 sint32 枚举，指定本地用户的默认登录方法。 登录类型将确定是否可以远程使用生成的令牌。 后文的“备注”部分列出了可能的值。
Path	（继承自 ConfigurationSection。）一个键属性。
Realm	一个读/写 string 值，该值包含客户端用于凭据缓存的领域的名称。
SectionInformation	（从 ConfigurationSection 继承。）

子类

此类不包含子类。

注解

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

值	关键字	说明
0	Interactive	此登录类型适用于将交互使用计算机的用户。
1	Batch	此登录类型适用于批处理服务器，无需用户直接干预即可代表用户执行进程。 不缓存此登录类型的凭据。
2	Network	此登录类型适用于高性能服务器对明文密码进行身份验证。 不缓存此登录类型的凭据。
3	ClearText	此登录类型保留身份验证包中的姓名和密码，从而允许服务器在模拟客户端时连接到其他网络服务器。

示例

以下示例显示默认网站的 BasicAuthenticationSection 配置。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the Basic authentication section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "BasicAuthenticationSection", oBasicAuth  
  
' Display the path and location.  
WScript.Echo "Basic Authentication Settings"  
WScript.Echo "-----------------------------"  
WScript.Echo "Path: " & oBasicAuth.Path  
WScript.Echo "Location: " & oBasicAuth.Location  
WScript.Echo   
  
' Display the Enabled, DefaultLogonDomain, Realm, and   
' LogonMethod properties.  
WScript.Echo "Enabled: " & _  
    "[" & oBasicAuth.Enabled & "]"  
  
WScript.Echo "DefaultLogonDomain: " & _  
    "[" & oBasicAuth.DefaultLogonDomain & "]"  
  
WScript.Echo "Realm: " & "[" & oBasicAuth.Realm & "]"  
  
WScript.Echo "LogonMethod: " &  _  
    "[" & GetLogonMethodText(oBasicAuth.LogonMethod) & "]"  
  
' Translate the LogonMethod enumeration values 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 = "Undefined enumeration."  
    End Select  
End Function  
  

继承层次结构

ConfigurationSection

BasicAuthenticationSection

要求

类型	描述
客户端	- 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

另请参阅

AnonymousAuthenticationSection 类
AuthenticationSection 类
ClientCertificateMappingAuthenticationSection 类
DigestAuthenticationSection 类
FormsAuthenticationConfiguration 类
FormsAuthenticationCredentials 类
FormsAuthenticationUser 类
IisClientCertificateMappingAuthenticationSection 类
PassportAuthentication 类
WindowsAuthenticationSection 类
LogonUserEx