Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |