Share via

virtualDirectory Element for application for site for sites [IIS Settings Schema]

Note

For more information about the virtualDirectory element, see the following topic on the Microsoft IIS.net Web site: Virtual Directory <virtualDirectory>.

Specifies configuration settings for a virtual directory in the parent application.

Syntax

Attributes and Elements

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

Attributes

Attribute

Description

allowSubDirConfig

Optional Boolean attribute.

Specifies whether IIS looks for Web.config files in content directories lower than the current level (true) or does not look for Web.config files in content directories lower than the current level (false).

The default value is true.

logonMethod

Optional enum attribute.

Specifies the logon method for the virtual directory.

The logonMethod attribute can be one of the following possible values. The default is ClearText.

ValueDescription
BatchThis logon type is intended for batch servers, where processes may be executing on behalf of a user without their direct intervention. The numeric value is 1.
ClearTextThis logon type preserves the name and password in the authentication package, which allows the server to make connections to other network servers while impersonating the client. The numeric value is 3.
InteractiveThis logon type is intended for users who will be interactively using the computer. The numeric value is 0.
NetworkThis logon type is intended for high performance servers to authenticate plaintext passwords. Credentials are not cached for this logon type. The numeric value is 2.

For more information about these values, see LogonUser on the MSDN site.

password

Optional string attribute.

Specifies the password associated with the user name.

Note

To avoid storing unencrypted password strings in configuration files, always use Appcmd.exe or IIS Manager to enter passwords. If you use these management tools, the password strings will be encrypted automatically before they are written to the XML configuration files. This provides better password security than storing unencrypted passwords.

path

Optional string attribute.

Specifies the virtual path of the virtual directory.

physicalPath

Optional string attribute.

Specifies the physical path of the virtual directory.

userName

Optional string attribute.

Specifies the user name of an account that can access configuration files and content for this virtual directory.

Child Elements

None.

Parent Elements

Element

Description

configuration

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

system.applicationHost

Specifies the root element for configuring Web process settings.

sites

Specifies configuration settings for all sites on the server, and includes settings for applications and virtual directories in those sites.

site

Specifies configuration settings for a site.

application

Specifies configuration settings for an application in the parent site.

Remarks

For more information about the virtualDirectory element, see the following topic on the Microsoft IIS.net Web site: Virtual Directory <virtualDirectory>.

Element Information

Configuration locations

ApplicationHost.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0