VirtualDirectory Class2
Represents an IIS virtual directory.
Syntax
class VirtualDirectory : ConfiguredObject
Methods
The following table lists the methods exposed by the VirtualDirectory class.
| Name | Description |
|---|---|
| Create | Creates a virtual directory. |
| GetAllSections | (Inherited from ConfiguredObject.) |
| GetSection | (Inherited from ConfiguredObject.) |
| RevertToParent | Reverts a virtual directory's configuration value or values to those of its parent directory. |
Properties
The following table lists the properties exposed by the VirtualDirectory class.
| Name | Description |
|---|---|
AllowSubDirConfig |
A read/write boolean value. true if IIS looks for Web.config files in content directories lower than the current level; false if IIS does not look for these files in directories lower than the current level. The default is true. |
ApplicationPath |
A read-only string value that contains the path for the application to which the virtual directory belongs. A key property. |
LogonMethod |
A read/write sint32 enumeration that specifies how a user is locally logged on. The type of logon will determine whether the resulting token can also be used remotely. The possible values are listed later in the Remarks section. |
Password |
A read/write string value that specifies the encrypted password for access to the physical path for the virtual directory. |
Path |
A read-only string value that contains the virtual directory path. A key property. |
PhysicalPath |
A read/write string value that specifies the physical path associated with the virtual directory. |
SiteName |
A read-only string value that contains the name of the Web site to which the virtual directory belongs. A key property. |
UserName |
A read/write string value that specifies a user who has rights to access any configuration files or content in a virtual directory. The default is null. |
Subclasses
This class contains no subclasses.
Remarks
The following table contains the possible values and keywords for the LogonMethod property. The default is 3 (ClearText). For more information, see the LogonUserEx function.
| Value | Keyword | Description |
|---|---|---|
| 0 | Interactive |
This logon type is intended for users who will be interactively using the computer. |
| 1 | Batch |
This logon type is intended for batch servers, where processes may be executing on behalf of a user without their direct intervention. Credentials are not cached for this logon type. |
| 2 | Network |
This logon type is intended for high performance servers to authenticate plaintext passwords. Credentials are not cached for this logon type. |
| 3 | ClearText |
This 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. |
Example
The following example sets the physical path for the default Web site.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the root virtual directory for the default Web site.
Set oVDir = oWebAdmin.Get(_
"VirtualDirectory.SiteName='Default Web Site',ApplicationPath='/',Path='/'")
' Set the physical path for the default Web site.
oVDir.PhysicalPath = "C:\MyContent"
oVDir.Put_
Inheritance Hierarchy
VirtualDirectory
Requirements
| Type | Description |
|---|---|
| Client | - IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016 |
| Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF file | WebAdministration.mof |