Partager via


IIS WMI Provider Architecture

The WMI provider, like the ADSI provider, provides a standard syntax for accessing IIS configuration data through the use of the IIS admin objects.

IIS 5.1 and earlier: The IIS WMI provider is not available.

Note

There has been a change in the IIS WMI provider for Windows Server 2003 Service Pack 1 and Windows XP Service Pack 2 that requires customers to update WMI-based scripts that operate over a remote connection. WMI-based scripts that do not encrypt the connection when administering IIS remotely fail with an Access Denied error (WBEM_E_ACCESS_DENIED, 0x80041003). You must use the AuthenticationLevel property.

For information on how to configure encryption in WMI-based scripts, see Encrypting Data When Running WMI-Based Remote Administration Scripts in the IIS Administration Guide.

The following illustration shows the organization of classes in the IIS WMI provider. Each class type is defined in the sections that follow the diagram.

IIS WMI Provider Class Structure

Element Classes and Settings Classes

The classes that are defined in the MicrosoftIISv2 namespace correspond to the IIS metabase schema. For each IIS admin object, there are two classes:

The IIS admin objects were split in this way to take advantage of the inheritance of special properties and methods from the CIM_ManagedSystemElement class.

Association Classes

There are two association classes in the IIS WMI provider:

  • The CIM_Component association class

    This association class exposes relationships between element classes to mimic ADSI containment. The properties of CIM_Component association classes are references to the two associated element classes. Every possible association between element classes in the CIM_ManagedSystemElement class is represented by an element in the CIM_Component class.

  • The CIM_ElementSetting association class

    This association class exposes relationships between element classes and settings classes. The properties of CIM_ElementSetting association classes are references to the associated element and settings class. Every possible association between elements in the CIM_ManagedSystemElement class and elements in the CIM_Setting (WMI) class is represented by an element in the CIM_ElementSetting class.

Structured Data Class

The IIsStructuredDataClass class contains elements that represent metabase properties that contain data in a multipart format. For example, in the ADSI provider, the ServerBindings property is a multiple string where each string must be formatted as IP:Port:Hostname. If the parts are out of order, or if there are missing colons, an error occurs.

In the WMI provider, an element class was created called ServerBinding, which has three properties that correspond to the IP address, the port number, and the host name. An instance of a class such as the IIsWebServerSetting settings class can contain a property called ServerBindings, which is an array of ServerBinding objects.

Inherited Properties and Methods

IIS WMI provider objects inherit methods from the IWbemClassObject COM interface and the SWbemObject scripting object. These inherited methods manipulate the data in the metabase. The following table lists frequently used inherited methods and properties.

IWbemClassObject methods

IWbemClassObject properties

BeginEnumeration

Delete

EndEnumeration

Get

Next

Put

SpawnInstance

None.

SWbemObject methods

SWbemObject properties

Associators_

Delete_

Put_

SpawnInstance_

Path_

Properties_

See Also

Other Resources

Windows Management Instrumentation Platform SDK