Ensure Application

This is generated from the built in components of BuildMaster 7.0.0, and may be different than what you have installed (especially if you have extensions); go to [User Icon] -> Documentation within your BuildMaster instance to see exactly what operations are available.

Ensure Application

Ensures the existence of an application within an IIS site.

Script usage:

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

Arguments:

Name	Format	Script Usage	Usage Notes
☆ Site name	text	Site	The name of this site where the application would exist This argument is required.
☆ Application path	text	Path	The relative URL of the path, such as /hdars This argument is required.
Application pool	text	AppPool	The name of the application pool assigned to the application.
Physical path	text	PhysicalPath	Physical path to the content for the application, 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 application.
Otter credentials	text	Credentials	The Otter credential name to be impersonated when accessing the physical path for the application. 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

Name

Format

Script Usage

Usage Notes

☆ Site name

text

Site

The name of this site where the application would exist This argument is required.

☆ Application path

text

Path

The relative URL of the path, such as /hdars This argument is required.

Application pool

text

AppPool

The name of the application pool assigned to the application.

Physical path

text

PhysicalPath

Physical path to the content for the application, 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 application.

Otter credentials

text

Credentials

The Otter credential name to be impersonated when accessing the physical path for the application. 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

Example:

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

Ensure Application