Description

The IIS-AppCmd plugin is an automation-based plugin. It is used during the deployment to automate configuration changes to IIS versions 7 up to version 8. IIS is packaged with Windows Server.

Microsoft’s IIS 7 is packaged with Windows Server 2008.
Microsoft’s IIS 7.5 is packaged with Windows Server 2008r2.
Microsoft’s IIS 8 is packaged with Windows Server 2010.

Quick Info

Product
HCL Launch
Type
plugin
Compatibility
HCL Launch version 7.0 or later
Created by
HCL Software
Website
Version Name Action

5.869083

launch-iis-appcmd-5.869083.zip

6.1108801

launch-iis-appcmd-6.1108801.zip

launch-iis-appcmd-5.869083.zip

5.869083


launch-iis-appcmd-6.1108801.zip

6.1108801


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 or later.

Installation

See Installing plugins in HCL Launch for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
6 Minor enhancements
5 Minor enhancements

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
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

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