APPLICATION Command

  • Article

AC APPLICATION allows you to manage applications on a cluster. An application is defined as a collection of resources and can include:

  • Web sites and certificates.

  • COM+ applications.

  • Registry keys.

  • Files and DSNs.

The AC APPLICATION command allows you to:

  • Create an application on or delete an application from a cluster or member.

  • Add resources to or remove resources from an application.

  • List applications and resources.

Usage

AC APPLICATION   /CREATE
                 [/MEMBER:member_name]
                 [/USER:username /PASSWORD:password]
                 /NAME:appl_name
                 [/MEMBERONLY]
    
AC APPLICATION   /DELETE
                 [/MEMBER:member_name]
                 [/USER:username /PASSWORD:password]
                 {/NAME:appl_name | /GUID:appl_guid}
                 [/MEMBERONLY]

AC APPLICATION   /LIST
                 [/MEMBER:member_name]
                 [/USER:username /PASSWORD:password]
                 [/MEMBERONLY]

AC APPLICATION   /ADDRESOURCE
                 [/MEMBER:member_name]
                 [/USER:username /PASSWORD:password]
                 {/NAME:appl_name | /GUID:appl_guid} 
                 /RESOURCETYPE:resource_type
                 /RESOURCEPATH:resource_path
                 [/MEMBERONLY]
   
AC APPLICATION   /REMOVERESOURCE
                 [/MEMBER:member_name]
                 [/USER:username /PASSWORD:password]
                 {/NAME:appl_name | /GUID:appl_guid} 
                 /RESOURCETYPE:resource_type
                 /RESOURCEPATH:resource_path
                 [/MEMBERONLY]

AC APPLICATION   /LISTRESOURCES
                 [/MEMBER:member_name]
                 [/USER:username /PASSWORD:password]
                 {/NAME:appl_name | /GUID:appl_guid}
                 [/MEMBERONLY]

Parameters

Parameter

Description

/CREATE

Specifies that you want to create an application on an existing cluster or member.

/MEMBER:member_name

Specifies a cluster member. If omitted, the local member is assumed.

/USER:username

Specifies the user name to use for authentication, which can be supplied as "domain\username".

/PASSWORD:password

Specifies the password to use for authentication.

/NAME:appl_name

Specifies the name of the application being managed.

/MEMBERONLY

Specifies that the command should be run on the specified member, not on the controller.

/DELETE

Indicates that you want to delete an application on a cluster member.

/GUID:appl_guid

Specifies the GUID of the application being managed.

/LISTRESOURCES

Displays a list of all existing resources for a given application.

/ADDRESOURCE

Indicates that you want to add a single resource to a single application on the controller of the cluster to which the specified member belongs. You must specify the fully qualified path to the resource to add it to the designated application. If /MEMBERONLY is specified, the resource is added only to the specified member, not to the controller.

/RESOURCETYPE:resource_type

Specifies the resource to be added to or removed from the application. The following are valid resource types:

  • FileSystem

  • IIS

  • Registry

  • DSN

  • COMPlusApp

/RESOURCEPATH:resource_path

Specifies the path to the resource to add to or remove from the application. Paths are specified as follows:

  • IIS: the complete metabase path. For example, "/LM/W3SVC/3" or site name ("My Web Site").

  • Registry: the complete registry path. For example, "HKEY_CURRENT_USERS\Software\Microsoft\ Active Setup\{guid}".

  • FileSystem: the complete file system path. For example, "C:\Program Files\Misc\ MyResource.txt".

  • DSN: the friendly name of the DSN (for example, "My DSN") or unique registry path, such as "My Computer\HKEY_LOCAL_MACHINE\Software\ ODBC\ODBC.INI\Name".

  • COMPlusApp (COM+ application): the friendly name of the COM+ application or its GUID (CLSID).

/REMOVERESOURCE

Indicates that you want to remove a single resource from a single application on the controller of the cluster to which the member belongs. If /MEMBERONLY is specified, the resource is removed only from the specified member, not from the controller.

Samples

The following example shows how to create an application named gamescentral on all the members of an existing cluster.

AC APPLICATION /CREATE /NAME:gamescentral

The following example shows how to add a Web site resource to the application salesui.

AC APPLICATION /ADDRESOURCE /NAME:salesui /RESOURCETYPE:iis
/RESOURCEPATH:host1/b_svc/2/root/myvirtualdirectory

The following example shows how to remove a file resource from the application salesui.

AC APPLICATION /REMOVERESOURCE /NAME:salesui /RESOURCETYPE:filesystem
/RESOURCEPATH:"c:\Program Files\Resources\MyFile.txt"

Did you find this information useful? Please send your suggestions and comments about the documentation to acdocs@microsoft.com.