共用方式為


IIS ADSI Provider Architecture

The ADSI provider, like the WMI provider, provides a standard syntax for accessing IIS configuration data through the use of the IIS admin objects. The admin objects in the IIS ADSI provider inherit useful methods and properties from Windows ADSI objects and container objects that help configure data in the metabase.

ms525929.alert_caution(en-us,VS.90).gifImportant Note:

When using ADSI to configure IIS, ensure that the user account of the person running the script is a member of the administrators group or use LogonAdmin to run the script under the credentials of an administrator.

For more information, see User authentication issues with the ADSI WinNT provider.

ADSI Objects

Each of the objects of the IIS ADSI provider map to an IIS admin object and implement the IADs interface that is defined by the ADSI standard. This interface provides the following basic functionality:

  • Set and retrieve configuration properties on a specific node in the metabase.

  • Retrieve the path of the object's parent container object.

  • Retrieve namespace properties.

  • Provide binding information that uniquely identifies the object instance in a directory tree.

  • Provide a path to the schema definition of the object.

  • Provide identification information that indicates the name and type of the object.

  • Provide a simple, implicit caching system.

The IIS ADSI provider supports the following IADs interface properties and methods on each of the admin objects. The IIS ADSI provider also supports IIS-specific metabase properties and IIS-specific ADSI methods that are needed for IIS configuration and administration.

IADs property methods

IADs methods

ADsPath

Class

GUID

Name

Parent

Schema

Get

GetEx

GetInfo

Put

PutEx

SetInfo

ADSI Container Objects

IIS admin objects that can contain other admin objects are called container objects. For example, the diagram in the topic IIS Admin Object Hierarchy illustrates that the IIsComputer object can contain the IIsWebService and IIsFtpService objects. Container objects can implement the IADsContainer interface in addition to the IADs interface.

The IADsContainer interface provides a way to implement the following tasks:

  • Create objects within the container.

  • Delete objects from the container.

  • Count the number of objects within the container.

  • Enumerate the contained objects.

  • Access the contained objects.

The IIS ADSI provider supports the following properties and methods on each of the admin objects that are container objects:

IADsContainer property methods

IADsContainer methods

NewEnum

Count

CopyHere

Create

Delete

GetObject

MoveHere

See Also

Other Resources

Windows Active Directory Service Interfaces Reference