Windows-based Hosting::AddPlansToCustomer

  • Article

The AddPlansToCustomer procedure adds valid service plans to a customer organizational unit and reserves any required resources.

Arguments

The AddPlansToCustomer procedure requires the following input parameters.

Input Argument Description

<org>

The Lightweight Directory Access Protocol (LDAP) path of the organization that will own the Web site.

<plans>/<planName>

One or more valid Customer Service Plans that will be assigned to the customer.

<preferredDomainController>

The name of the preferred domain controller.

Output Arguments

The AddPlansToCustomer procedure has no return values.

Remarks

Security

The AddPlansToCustomer procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for OrgCreator permissions.

Process Steps

The following steps occur when adding Customer Service Plans with the AddPlansToCustomer procedure of the Managed Windows-based Hosting Namespace:

  • Associate service plans with the customer.

  • Call appropriate resource management procedures to reserve resources based on Customer Service Plan attributes.

Sample Code

Example XML Request

The following is an example of an XML request for the AddPlansToCustomer procedure of the Managed Windows-based Hosting Namespace:

<request> 
        <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="AddPlansToCustomer" impersonate="1"> 
                        <executeData> 
                        <preferredDomainController>AD01.fabrikam.com 
                        </preferredDomainController> 
                        <org>LDAP://OU=northwindtraders, 
                        OU=consolidatedmessenger,OU=Hosting, 
                        DC=fabrikam,DC=Com</org> 
                        <plans> 
                                <planName>BasicWeb</planName> 
                                <planName>BasicData</planName> 
                                <planName>BasicSharepoint</planName> 
                        </plans> 
                        </executeData> 
                </execute> 
        </procedure> 
</request>

Applies To

Managed Windows-based Hosting Namespace API for:

  • 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

See also

Tasks

Windows-based Hosting::ChangeCustomerPlan
Windows-based Hosting::RemovePlansFromCustomer