Ensure Application
  • 16 Feb 2022
  • 1 Minute to read
  • Dark
    Light
  • PDF

Ensure Application

  • Dark
    Light
  • PDF

Article Summary

This is generated from the built in components of Otter 3.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:

NameFormatScript UsageUsage 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
);

Was this article helpful?