Remove Registration for a Native Module on a Web Server (IIS 7)

  • Article

Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Vista

You can remove the registration for a native module on a Web server if none of the applications that are running on the server require the module for processing. Removing a native module from a Web server means that the module is removed from the list of active modules; however, the code still exists on the Web server. You can add and enable the native module again if application requirements change.

Important

If a native module is enabled in the <modules> list in addition to the <globalModules> list, it will be removed from the <modules> list also.

Prerequisites

For information about the levels at which you can perform this procedure, and the modules, handlers, and permissions that are required to perform this procedure, see Native Modules Feature Requirements (IIS 7).

Exceptions to feature requirements

  • Only server administrators can remove registration for native modules on the Web server.

  • Native module registration can be removed only at the server level in IIS 7.

To remove registration for a native module on a Web server

You can perform this procedure by using the user interface (UI), by running Appcmd.exe commands in a command-line window, by editing configuration files directly, or by writing WMI scripts.

User Interface

To use the UI

  1. Open IIS Manager and click the server connection in the tree in the Connections pane. For information about opening IIS Manager, see Open IIS Manager (IIS 7).

  2. In Features View, on the serverHome page, double-click Modules.

  3. On the Modules page, in the Actions pane, click Configure Native Modules.

  4. In the Configure Native Modules dialog box, select the native module that you want to remove and then click Remove.

  5. On the Confirm Remove dialog box, click Yes and then click OK.

Command Line

To remove registration for a native module on a Web server, use the following syntax:

**appcmd uninstall module /name:**string

The variable namestring is the name of your native module. For example, to remove registration for a module named ImageCopyrightModule, type the following at the command prompt, and then press ENTER:

appcmd uninstall module /name:ImageCopyrightModule

For more information about Appcmd.exe, see Appcmd.exe (IIS 7).

Configuration

The procedure in this topic affects the following configuration elements:

<globalModules>

<modules>

For more information about IIS 7 configuration, see IIS 7.0: IIS Settings Schema on MSDN.

WMI

Use the following WMI classes, methods, or properties to perform this procedure:

  • GlobalModulesSection class

For more information about WMI and IIS, see Windows Management Instrumentation (WMI) in IIS 7. For more information about the classes, methods, or properties associated with this procedure, see the IIS WMI Provider Reference on the MSDN site.

See Also

Concepts

Configuring Native Modules (IIS 7)
Configuring Modules in IIS 7