Microsoft KB Archive/267904

= The MetaAcl tool for modifying metabase permissions on the IIS Admin Objects is available =

Article ID: 267904

Article Last Modified on 12/3/2007

-

APPLIES TO


 * Microsoft Internet Information Services 5.0
 * Microsoft Internet Information Services 6.0

-



This article was previously published under Q267904



Important This article contains information about how to edit the metabase. Before you edit the metabase, verify that you have a backup copy that you can restore if a problem occurs. For information about how to do this, see the &quot;Configuration Backup/Restore&quot; Help topic in Microsoft Management Console (MMC).



SUMMARY
You can use the MetaAcl.vbs tool to modify the default permissions that are set on an Internet Information Services (IIS) metabase.

You might have been redirected to this Microsoft Knowledge Base article from the following IIS error message:

System.Web.Hosting.HostingEnvironmentException: Failed to access IIS metabase. The process account used to run ASP.NET must have read access to the IIS metabase (e.g. IIS://servername/W3SVC). For information on modifying metabase permissions, please see http://support.microsoft.com/?kbid=267904.

You receive this error message because the permissions to the metabase are insufficient, or because the permissions are set incorrectly.

To help resolve this error, use the MetaAcl tool to modify the metabase permissions. For more information about the MetaAcl tool and about how Access Control Lists (ACLs) work, click the following article number to view the article in the Microsoft Knowledge Base:

326902 ACLs and using MetaAcl for metabase ACL permission changes



MORE INFORMATION
The following file is available for download from the Microsoft Download Center:

Download the Metaacl.exe package now.

Release Date: July 16, 2003

For more information about how to download Microsoft support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to obtain Microsoft support files from online services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help prevent any unauthorized changes to the file.

The Metaacl.exe file contains the following files:

For a full discussion about how to use the MetaAcl.vbs tool, click the following article in the Microsoft Knowledge Base:

326902 ACLs and using MetaAcl for metabase ACL permission changes

Note If you are using ASP.Net 2.0 and you must grant metabase permissions to a Windows user account, do not use the MetaAcl tool. Instead, run the ASP.NET IIS Registration Tool command together with the -ga option. For example, the following command grants the Windows user account  permissions to the IIS metabase:

aspnet_regiis -ga 

Warning If you edit the metabase incorrectly, you can cause serious problems that may require that you reinstall any product that uses the metabase. Microsoft cannot guarantee that problems that result if you incorrectly edit the metabase can be solved. Edit the metabase at your own risk.

Note Always back up the metabase before you edit it.

