IIS Site Namespace API

This section provides the details of the application programming interface (API) for the IIS Site namespace included with the Microsoft Provisioning System (MPS) in . This document describes the procedures of this namespace along with their input parameters and return values. In addition, example Extensible Markup Language (XML) requests are provided along with a typical XML response that the provisioning system returns after the request is submitted to MPS and tasks are completed.

Developers should use this API document as a reference when creating XML requests that initiate provisioning tasks to manipulate IIS functionality.

Overview

The IIS Site namespace is a set of namespaces for the Microsoft Provisioning Framework (MPF). It adds functionality to MPF to assist in the creation and maintenance of IIS Web and File Transfer Protocol (FTP) sites. Conceptually, this namespace enhances the IIS Provider, which is the low-level MPF provider that allows manipulation of the IIS metabase.

There are two levels of enhancement offered by the IIS Site namespace. The first level of enhancement integrates file system manipulation with metabase manipulation, allowing Web and FTP sites to be manipulated as a conceptual unit instead of as a disjoint of file system settings and unrelated metabase settings.

The second level of enhancement integrates Active Directory directory service permission assignments. The IIS Site namespace is designed to avoid enforcing any business logic, and it provides only minimal default business logic where absolutely necessary. All of the default business logic that is provided may be overridden by the caller.

Purpose

The goal of the IIS Site namespace is to integrate the Internet Information Services (IIS) metabase, file system, and Active Directory into a single API that allows creation and administration of Web and FTP sites.

Public Method Description

IIS Site::CreateSite

Creates an IIS Web or FTP site and provides the option to set permissions on file system directories for content and logging.

IIS Site::ModifySite

The modification of Web and FTP site parameters is handled directly by the IIS 6.0 Provider GetProperties and SetProperties calls.

IIS Site::DeleteSite

Deletes a Web or FTP site and provides the option to move the content directory to an archive location.

Applies To

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0