IPSecuritySection 类

根据 IP 地址相关信息配置对 Web 服务器内容的访问。

语法

class IPSecuritySection : ConfigurationSectionWithCollection  

方法

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

名称	说明
添加	（继承自 ConfigurationSectionWithCollection。）
清除	（从 ConfigurationSectionWithCollection 继承。）
Get	（从 ConfigurationSectionWithCollection 继承。）
GetAllowDefinition	（继承自 ConfigurationSection。）
GetAllowLocation	（从 ConfigurationSection 继承。）
删除	（从 ConfigurationSectionWithCollection 继承。）
RevertToParent	（从 ConfigurationSection 继承。）
SetAllowDefinition	（从 ConfigurationSection 继承。）
SetAllowLocation	（从 ConfigurationSection 继承。）

属性

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

名称	描述
AllowUnlisted	一个读/写 boolean 值。 如果授予 IPAddressFilters 属性中未指定的 IP 地址、域名和子网掩码组合的访问权限，则为 true；否则为 false。 默认为 true。 此属性在排序最后进行处理。 注意：如果使用本地主机地址 (127.0.0.1)，并且 AllowUnlisted 属性设置为 false，除非将 127.0.0.1 指定为 IPSecurity 条目，其 Allowed 属性设置为 true，否则用户访问将被拒绝。
EnableReverseDNS	一个读/写 boolean 值。 如果执行反向 DNS 查找来验证 IP 地址解析的域名，则为 true；否则，为 false。 默认为 false。 注意：启用此属性后，IIS 必须解析每个客户端 IP 地址的 DNS 名称。 单个 DNS 查找可能需要花费几秒钟，IIS 需要等待直到域名被验证。 规划大规模实现时，应考虑此行为。
IpSecurity	一个由读/写 IPAddressFilterElement 值构成的数组，指定需要对其授予或拒绝访问权限的 IP 地址、域名和子网掩码组合。 注意：此属性中的条目将按顺序处理。 最佳做法是将要拒绝的条目首先放在列表中。
Location	（继承自 ConfigurationSection。）一个键属性。
Path	（继承自 ConfigurationSection。）一个键属性。
SectionInformation	（从 ConfigurationSection 继承。）

子类

此类不包含子类。

注解

在 IIS 6.0 中，URL 将被单独授权或拒绝。 但是，在 IIS 7 中，将继承访问规则并合并其语义以确定最终访问权限，这就是为什么规则顺序很重要的原因。

示例

以下示例显示默认网站的 IPSecuritySection 设置。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the IP security section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "IPSecuritySection", oSection  
  
' Display the Path and Location properties.  
WScript.Echo "=============================="  
WScript.Echo "IP Security Section Properties"  
WScript.Echo "=============================="  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
WScript.Echo  
  
' Display the AllowUnlisted and   
' EnableReverseDns properties.  
WScript.Echo "AllowUnlisted: " & oSection.AllowUnlisted  
WScript.Echo "EnableReverseDns: " & _  
                oSection.EnableReverseDns  
WScript.Echo  
  
' Display the IP and domain restrictions.  
WScript.Echo "--------------------------"  
WScript.Echo "IP and domain restrictions"  
WScript.Echo "--------------------------"  
For Each oIPAddressFilter In oSection.IpSecurity  
    WScript.Echo "IpAddress: " & oIPAddressFilter.IpAddress      
    WScript.Echo "DomainName: " & _  
        oIPAddressFilter.DomainName  
    WScript.Echo "SubnetMask: " & _  
        oIPAddressFilter.SubnetMask  
    WScript.Echo "Allowed: " & oIPAddressFilter.Allowed  
    WScript.Echo  
Next  
  

继承层次结构

ConfigurationSection

ConfigurationSectionWithCollection

IPSecuritySection

要求

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

另请参阅

ConfigurationSectionWithCollection 类
IPAddressFilterElement 类