Feature and Component Associations for IIS Support

InstallShield 2020

Project:This information applies to the following project types:

Basic MSI
DIM
InstallScript
InstallScript MSI
Merge Module

There is a one-to-many relationship between components and IIS data (that is, Web sites, applications, virtual directories, application pools, or Web service extensions). Therefore, you can associate more than one IIS element with a single component. If a component is being installed, any Web sites, applications, virtual directories, application pools, and Web service extensions that are associated with the component are created at run time.

Project:If a Web site is associated with a component in an InstallScript project, any applications or virtual directories that are added to that Web site must be associated with the same component. Therefore, if you try to change the component for a Web site that contains one or more applications or virtual directories, InstallShield displays a message box to inform you that it will also make the same component change for all of that Web site’s applications and virtual directories; InstallShield also displays this message box if you try to change the component for any applications or virtual directories in a Web site. In either case, the message box enables you to proceed or cancel the component change.

Note that for Basic MSI, DIM, InstallScript MSI, and Merge Module projects, keeping a Web site in the same component as all of the Web site’s applications and virtual directories is not required, but it is recommended.

If you are creating an application pool in an InstallScript project and you want the application pool to be associated with a virtual directory, application, or Web site, you must create the application pool and the virtual directory, application, or Web site within the same component. If you do this, the application pool is created before the virtual directory, application, or Web site is created. This is a requirement of IIS 6 and later, and it is not a limitation for Basic MSI, DIM, InstallScript MSI, or Merge Module projects.

At any time, you can use the Internet Information Services view to change which component contains the Web site, application, virtual directory, application pool, or Web service extension.

To associate a Web site, application, virtual directory, application pool, or Web service extension with a different component in your project:

1. In the View List under Server Configuration, click Internet Information Services.
2. In the explorer, click the Web site, application, virtual directory, application pool, or Web service extension that you want to associate with a component.
3. In the Component setting, select the name of the existing component that should contain the selected IIS data. You can click the ellipsis button (...) to select an existing component or create a new one for the IIS data.

Tip:If you delete a component in your project, any Web sites, applications, virtual directories, application pools, and Web service extensions that are associated with the component are simultaneously removed from your project.

See Also