Summary
The MicroSoft IIS AppCmd plugin provides for automation of configuration changes to IIS version7 up to version 8 during a deployment. You can use the plugin to create an applications and application pools in IIS and more.
This plugin includes one or more steps, click Steps for step details and properties.
Compatibility
This plugin requires HCL Launch version 7.0.x or later.
Installation
See Installing plugins in HCL Launch for installing and removing plugins.
Steps
The following process steps are available in the IIS AppCmd plugin.
AppCmd
Run an arbitrary appcmd command.
Input properties for the AppCmd step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command |
String |
The command to be run using appcmd. |
Yes |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Identifier |
String |
The identifier for the object if required. |
No |
Object Type |
String |
The object type that the command should be run against. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Create Application
Create an Application in IIS.
Input properties for the Create Application step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Parent Site |
String |
The Parent site the application should be created under, For example: Default Web Site. |
Yes |
Virtual Path |
String |
The virtual path that this application should be created under. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Create Application Pool
Create an Application Pool in IIS.
Input properties for the Create Application Pool step
Name |
Type |
Description |
Required |
Application Pool Name |
String |
The name of the Application Pool to create. |
Yes |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Create Site
Create a new Web Site in IIS.
Input properties for the Create Site step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Site Name |
String |
The name of the Web Site to create, For example: DefaultWebSite. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Create Virtual Directory
Create a new Virtual Directory in IIS.
Input properties for the Create Virtual Directory step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Parent Application |
String |
Application identifier under which this virtual directory is created. |
Yes |
Path |
String |
The physical path of the virtual directory. |
No |
Virtual Path |
String |
The virtual path of the virtual directory. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Create or update application from XML
Create or update existing application using user supplied XML
Input properties for the Create or update application from XML step
Name |
Type |
Description |
Required |
Application Name |
String |
The application name. |
Yes |
Application XML |
String |
Enter the application configuration XML here or provide a path to a file below. |
No |
Application XML File |
String |
Enter a path to a file that contains the application configuration XML or provide
the contents above. |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Delete Application
Delete an Application from IIS.
Input properties for the Delete Application step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
ID |
String |
The Application path or URL of the application to delete, For example: Default Web Site/Application. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Delete Application Pool
Delete an Application Pool from IIS.
Input properties for the Delete Application Pool step
Name |
Type |
Description |
Required |
Application Pool Name |
String |
The name of the Application Pool to delete. |
Yes |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Delete Site
Delete a Web Site from IIS.
Input properties for the Delete Site step
TypeDescriptionRequired |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Site Name |
String |
The name of the Web Site to delete, For example: DefaultWebSite. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Delete Virtual Directory
Delete a Virtual Directory from IIS.
Input properties for the Delete Virtual Directory step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Virtual Directory Path |
String |
Virtual Directory Path or URL to be deleted, For example: Default Web Site/subdir. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Recycle Application Pool
Recycle an Application Pool in IIS.
Input properties for the Recycle Application Pool step
Name |
Type |
Description |
Required |
Application Pool Name |
String |
The name of the Application Pool to recycle. |
Yes |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Start Application Pool
Start an Application Pool in IIS.
Input properties for the Start Application Pool step
Name |
Type |
Description |
Required |
Application Pool Name |
String |
The name of the Application Pool to start. |
Yes |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Start Site
Start a Web Site in IIS.
Input properties for the
Start Site step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Site Name |
String |
The name of the Web Site to delete, For example: DefaultWebSite. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Stop Application Pool
Stop an Application Pool in IIS.
Input properties for the Stop Application Pool step
Name |
Type |
Description |
Required |
Application Pool Name |
String |
The name of the Application Pool to stop. |
Yes |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |
Stop Site
Stop a Web Site in IIS.
Input properties for the Stop Site step
Name |
Type |
Description |
Required |
Arguments |
String |
A newline separted list of arguments to be added to the appcmd call. For example: /arg1:val1\n/arg2:val2\n/arg3:val3 |
No |
Command Path |
String |
The directory location of the AppCmd command-line executable: For example: C:\Windows\system32\inetsrv\ |
No |
Site Name |
String |
The name of the Web Site to delete, For example: DefaultWebSite. |
Yes |
Timeout |
Integer |
Timeout, in seconds, at which the step will fail if action is not yet complete. |
No |