add Element for ipSecurity [IIS Settings Schema]

Note

For more information about the add element, see the following topic on the Microsoft IIS.net Web site: Adding IP Security <add>.

Adds an IP restriction to the collection of IP address restrictions.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute

Description

allowed

Optional Boolean attribute.

Specifies whether to allow access to the address space.

The default value is false.

domainName

Optional string attribute.

Specifies domain name on which to impose a restriction rule. You can use an asterisk (*) as a wildcard.

ipAddress

Optional string attribute.

Specifies the IP version 4 address on which to impose a restriction rule.

subnetMask

Optional string attribute.

Specifies the subnet mask with which to evaluate the IP address for this restriction rule. You can use a subnet mask to identify a range of IP addresses in an address space. The default value requires a direct match of the IP address being evaluated (effectively, a range of a single address).

The default value is 255.255.255.255.

Child Elements

None.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

system.webServer

Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

security

Specifies the section group that contains security-related sections.

ipSecurity

Specifies access restrictions based on IP version 4 address or DNS domain name.

Remarks

For more information about the add element, see the following topic on the Microsoft IIS.net Web site: Adding IP Security <add>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Directory Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0