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.
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.
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
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