Share via

How to: Find IIS Metabase Settings for ASP.NET Applications in Deployment Reports

  • Article

For each ASP.NET application in the deployment report, you can find the IIS metabase settings you need to deploy that application. In the XML deployment report, the "WebApplication" <Resource> element contains <Setting> elements that identify the IIS settings for that application.

Note

Some of these setting names, values, or types differ from their IIS counterparts and require translation before configuring them on the target server.

For more information, see the following topics:

To locate the IIS settings for an ASP.NET application in the deployment report

  1. Open the XML deployment report.

  2. Under the <Applications> element, locate the <Application> element for ASP.NET application.

  3. Under the <Application> element, locate the "WebApplication" <Resource> element.

    The "WebApplication" element contains <Setting> elements that identify the IIS settings needed for that application.

  4. For each <Setting> element, retrieve the value from the "Resultant" <Facet> element.

    Note

    Some <Setting> elements contain three <Facet> elements: "Assigned," "Resultant," and "Default." For an IIS setting, the "Default" value is obtained from the IIS Web server to which the application is bound on the deployment diagram. However, this "Default" value is obtained from the IIS Web server's WebSites resource and not from resources associated with the Web site endpoint to which the application is bound. Therefore, you need to correct this value at deployment. When settings from the default Web site are imported from an existing Web server, the WebSites resource in the Settings and Constraints Editor is renamed DefaultWebSite. However, its <Resource> element in the deployment report remains "WebSites."

Example

The following example contains a "WebApplication" <Resource> element for an ASP.NET application. The example contains a <Setting> element that describes one of the IIS settings for that application. The "AccessFlags" <Setting> element has three <Facet> elements; however, the "Resultant" <Facet> element contains the value needed for deployment.

<Resource Name="WebApplication" Definition="MyWebApp:MyWebApp.WebApplication" Extends="Microsoft_InternetInformationServices:WebApplication" InstanceId="0b7bb788-f676-4791-957d-92d73840fd97">
   ...
      <Setting Name="AccessFlags" Definition="Microsoft_InternetInformationServices:AccessFlags">
         <Facet Name="Assigned" Definition="Microsoft_InternetInformationServices:AccessFlags" State="Set" List="true" Null="true" />
         <Facet Name="Resultant" Definition="Microsoft_InternetInformationServices:AccessFlags" State="Set" List="true"> 
           <Value>AllowRead</Value> 
         </Facet>
         <Facet Name="Default" Definition="Microsoft_InternetInformationServices:AccessFlags" State="Set" List="true">
            <Value>AllowRead</Value>
         </Facet>
      </Setting>
   ...
</Resource>

See Also

Concepts

Overview of Deployment Using Deployment Reports

Reference

Overview of Key Sections in Deployment Reports