ADSI Features

The IIS Admin Objects are namespace providers in support of the ADSI standard for remote administration of directory service namespaces. This provides a standard syntax for addressing IIS configuration data. The IIS namespace is composed of the IIS Admin Objects and the metabase. The remote Internet Service Manager (HTML) for IIS uses the IIS Admin Objects.

You can reference one of the IIS Admin Objects by its path, which is the same as the path to the associated key in the metabase. For example, the IIS Admin Object for the first virtual Web server on the computer named MyComputer would be addressed by the ADSI path (ADsPath) IIS://MyComputer/W3SVC/1. The following VBScript code uses the path to the first virtual Web server to open the IIS Admin Object associated with the metabase key for that server on the computer named MyComputer. You can use LocalHost instead of MyComputer to access the computer on which IIS is running.

<% 
Dim VSvrObj 
Set VSvrObj = GetObject("IIS://MyComputer/W3SVC/1") 
%> 
 

ADSI Objects

The IIS Admin Objects each implement the IADs interface defined by the ADSI standard. The IADs interface for the IIS Admin Objects provides the following basic functionality:

• identification information that indicates the name and type of the object
  
  
• binding information that uniquely identifies the object instance in a directory tree
  
  
• a way to retrieve the path of the object's parent container object
  
  
• a way to retrieve the schema definition of the object
  
  
• a way to retrieve namespace properties
  
  
• a simple caching system

The IIS Admin Objects implement the IADs interface, supporting the Name, ADsPath, Class, GUID, Parent, and Schema properties in addition to IIS-specific metabase properties. The IADs GetInfo, SetInfo, Get, Put, GetEx, PutEx, and GetInfoEx methods are also supported in addition to others needed for IIS configuration administration. See the ADSI Object Properties and ADSI Object Methods topics in the Using the IIS Admin Objects section.

ADSI Container Objects

All of the IIS Admin Objects that can contain other objects also implement the IADsContainer interface defined by the ADSI standard, in addition to the IADs interface. Examples of IIS Admin Objects that support IADsContainer include IIsComputer, which can contain IIsWebService and IIsFtpService objects among others, and the IIsWebVirtualDir object, which can contain IIsWebDirectory and IIsWebFile objects, as well as additional IIsWebVirtualDir objects.

The IADsContainer interface permits objects to contain other objects and provides the following basic functionality:

• a way to count the number of objects within the container
  
  
• a way to enumerate through the contained objects
  
  
• a way to access contained objects
  
  
• a way to create objects within the container
  
  
• a way to delete objects from the container

The IIS Admin Objects that can contain other objects implement container object properties and methods by supporting the IADsContainer interface Count and _NewEnum properties and the GetObject, Create, and Delete methods. IIS Admin Objects also support the basic IADs interface properties and methods, and any IIS-specific properties and methods. For more information, see ADSI Container Object Properties and ADSI Container Object Methods.

© 1997 by Microsoft Corporation. All rights reserved.

  .