---
title: "Ensure Virtual Directory"
---
Ensures the existence of a virtual directory within an IIS site.
IIS::Ensure-VirtualDirectory(
Site: <text>,
[ApplicationPath: <text>],
Path: <text>,
[PhysicalPath: <text>],
[LogonMethod: <integer>],
[Credentials: <text>],
[UserName: <text>],
[Password: <text>],
[Exists: <true/false>]
);
Name | Format | Script Usage | Usage 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". |
# ensures that the hdars virtual directory pool is present on the web server
IIS::Ensure-VirtualDirectory(
Site: Hdars,
Path: /hdars,
PhysicalPath: C:\hdars
);