12.15. Enabling Direct Metabase Editing

Problem

You want to edit the metabase while IIS is still running. You may need to do this to configure metabase properties that are not accessible from the GUI.

Solution

Using a graphical user interface

  1. Open Internet Information Services (IIS) Manager.

  2. In the left pane, right-click on the node representing your IIS server and select Properties.

  3. Select the Enable Direct Metabase Edit checkbox and click OK.

You can now use Notepad or some other text editor to edit the %SystemRoot%\system32\inetsrv\MetaBase.xml file as desired while IIS is running.

Using a command-line interface

To enable edit-while-running from the local server's command line, you have to first stop all IIS services:

> iisreset /stop

Use a text editor to open the metabase configuration file %SystemRoot%\system32\inetsrv\MetaBase.xml and change the line:

EnableEditWhileRunning = "0"

to:

EnableEditWhileRunning = "1"

Save your changes and then type the following command to restart IIS services:

> iisreset /start

Using VBScript

' This code enables the direct metabase editing setting
' ------ SCRIPT CONFIGURATION ------
strComputer = "<ServerName>"
' ------ END CONFIGURATION ---------
set objServer = GetObject("IIS://" & strComputer)
objServer.EnableEditWhileRunning = 1
objServer.EnableHistory = 1
objServer.SetInfo
WScript.Echo "Successfully enabled direct metabase editing on server " & _
             objServer.Name

Discussion

When IIS is running, it uses an in-memory copy of the metabase. If you make a change ...

Get Windows Server Cookbook now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.