Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

Ensure Virtual Directory

Ensures the existence of a virtual directory within an IIS site.

Script usage:

IIS::Ensure-VirtualDirectory(
	Site: <text>,
	[ApplicationPath: <text>],
	Path: <text>,
	[PhysicalPath: <text>],
	[LogonMethod: <integer>],
	[Credentials: <text>],
	[UserName: <text>],
	[Password: <text>],
	[Exists: <true/false>]
);

Arguments:

NameFormatScript UsageUsage Notes
Site name
text
Site
The name of this site where the virtual directory would exist. This argument is required.
Application path
text
ApplicationPath
The relative URL of the application containing the virtual directory, such as /. Default value is "/".
Virtual path
text
Path
The relative URL of the path, such as /hdars. This argument is required.
Physical path
text
PhysicalPath
Physical path to the content for the virtual directory, such as c:\hdars.
Logon method
integer
LogonMethod
Specifies the type of the logon operation to perform when calling LogonUser to acquire the user token impersonated to access the physical path for the virtual directory.
Otter credentials
text
Credentials
The Otter credential name to be impersonated when accessing the physical path for the virtual directory. If a credential name is specified, the username and password fields will be ignored.
User name
text
UserName
Password
text
Password
Exists
true/false
Exists
Default value is "True".

Example:


# ensures that the hdars virtual directory pool is present on the web server
IIS::Ensure-VirtualDirectory(
    Site: Hdars,
    Path: /hdars,
    PhysicalPath: C:\hdars
);