Managed Windows-based Hosting Namespace API

This section provides the details of the application programming interface (API) for the Managed Windows-based Hosting Namespace included with the Microsoft Provisioning System (MPS).

It describes the procedures of this namespace along with method input parameters and return values. In addition, example XML requests are provided along with a typical Extensible Markup Language (XML) response that the provisioning system returns after a request is submitted to MPS and tasks are completed. Developers should use this API document as a reference when creating XML requests that initiate the provisioning of Web, Data, Microsoft Windows SharePoint Services, Microsoft Active Directory directory service, and Domain Name System (DNS) services.


The Managed Windows-based Hosting Namespace is a new high-level namespace that provides a select set of Microsoft Provisioning Framework (MPF) named procedures for the provisioning of customer service plans, Web sites, databases, Windows SharePoint Services, Active Directory, and DNS hosted services with MPS. The namespace comprises the upper level of a three layer namespace architecture that is now implemented in MPS. The Managed Windows-based Hosting Namespace enhances underlying managed namespaces by integrating them with service plan and resource management logic.

Public Methods
Public Method Description
Windows-based Hosting::CreatePlan Adds a new plan to the available plans.
Windows-based Hosting::EnablePlan Enables a plan.
Windows-based Hosting::DisablePlan Disables a plan.
Windows-based Hosting::CreateResellerOrganization The CreateResellerOrganization procedure creates a reseller organization.
Windows-based Hosting::CreateCustomerOrganization The CreateCustomerOrganization procedure creates a customer organization.
Windows-based Hosting::CreatePlan The CreatePlan procedure creates a new plan.
Windows-based Hosting::CreateUser The CreateUser procedure creates a new user within a specified organization according to the policy name passed in as <policyName>. Possible values for this tag are "hosting," "reseller," "customer," and "default." The default policy creates only the requested organization. The exact behaviors of these policies are defined in the GetPolicy procedure in the Managed Active Directory namespace.
Windows-based Hosting::DeleteOrganization The DeleteOrganization procedure deletes an organization, de-allocates resources, and marks the organization as deleted in the Customer Service Plans database.
Windows-based Hosting::DeleteUser The DeleteUser procedure deletes a user, de-allocates resources, marks the user deleted in the Customer Service Plans database, and records a billing event.
Windows-based Hosting::AddPlansToCustomer The AddPlansToCustomer procedure adds valid service plans to a customer organizational unit and reserves any required resources.
Windows-based Hosting::ChangeCustomerPlan The ChangeCustomerPlan procedure changes a customer's service plan to another plan of the same type.
Windows-based Hosting::RemovePlansFromCustomer The RemovePlansFromCustomer procedure removes service plans from a customer organizational unit and releases any resources as necessary.
Windows-based Hosting::QueryPlans The QueryPlans procedure returns a list of plans.
Windows-based Hosting::QueryCustomerPlans The QueryCustomerPlans procedure returns a list of plans for a specified customer.
Windows-based Hosting::QueryServicesByCustomer The QueryServicesByCustomer procedure queries all service plan, resource, and provisioned service details for a customer and returns a listing of plans and provisioned services for a customer organizational unit.
Windows-based Hosting::DeleteCustomerWebSite
Windows-based Hosting::DeleteCustomerWebSite The DeleteCustomerWebSite procedure deletes a customer Web site and associated directories.
Windows-based Hosting::ModifyCustomerWebSite The ModifyCustomerWebSite procedure modifies an existing hosted Web site.
Windows-based Hosting::ControlCustomerWebSite The ControlCustomerWebSite procedure starts, stops, or pauses a customer Web site.
Windows-based Hosting::CreateCustomerDatabase The CreateCustomerDatabase procedure creates a database for a specified customer and optionally creates a customer directory structure on a specified share for data (mdf) and log (ldf) file. The size of the database is retrieved from the Customer Service Plans database and is based on customer's plan. The size is then applied to set the dataFile size (total allowed by plan is 1 mg for logFile).
Windows-based Hosting::DeleteCustomerDatabase The DeleteCustomerDatabase procedure deletes a database for a specified customer and cleans up the specified file directory.
Windows-based Hosting::ModifyCustomerDatabaseFile The ModifyCustomerDatabaseFile procedure modifies settings for a specified database. This procedure is used to modify the size of the database dataFile and customer database's allocation. This procedure should not be used to modify the datalog file.
Windows-based Hosting::CreateCustomerSharePointSite The CreateCustomerSharePointSite procedure creates a Windows SharePoint site collection for a customer.
Windows-based Hosting::DeleteCustomerSharePointSite The DeleteCustomerSharePointSite procedure deletes a Windows SharePoint site collection for a customer.
Windows-based Hosting::AddUserToSharePointSiteRole The AddUserToSharePointSiteRole procedure adds a user to a Windows SharePoint site role.
Windows-based Hosting::RemoveUserFromSharePointSiteRole The RemoveUserFromSharePointSiteRole procedure deletes a user from a Windows SharePoint site role.
Windows-based Hosting::CreateDNSZone The CreateDNSZone procedure creates a zone on a specified DNS server.
Windows-based Hosting::DeleteDNSZone The DeleteDNSZone procedure deletes a zone on a specified DNS server.
Windows-based Hosting::CreateResourceRecord The CreateResourceRecord procedure creates a resource record for a specified zone on a specified DNS server.
Windows-based Hosting::DeleteResourceRecord The DeleteResourceRecord procedure deletes a resource record for a specified zone on a specified DNS server.
 Applies To