Windows-based Hosting::DeleteCustomerWebSite

  • Article

The DeleteCustomerWebSite procedure deletes a customer Web site and associated directories.

Arguments

The DeleteCustomerWebSite procedure has the following input parameters.

Input Argument Description

<org>

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

<webSiteName> or <location>

The unique web site name that was established when the site was created or the IIS metabase path.

<preferredDomainController>

The name of the preferred domain controller.

<archiveShare>

The UNC path to the share for archiving Web content. This path must be accessible via the MPF server and the account that is submitting this request must have permissions to create directories on that share (e.g. \\WEB01\ContentArchive). If provided, the procedure will copy the contents of the web site's directory to this location prior to deletion. Otherwise, the content will simply be deleted.

Output Arguments

The DeleteCustomerWebSite procedure has no return values.

Remarks

Security

The DeleteCustomerWebSite procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for OrgCreator permissions.

Process Steps

The following steps occur when deleting a customer Web site with the DeleteCustomerWebSite procedure of the Managed Windows-based Hosting Namespace:

  • De-allocate resources associated with this site.

  • Delete the web site, directories, and Active Directory pointers by calling Managed Web Hosting::DeleteCustomerWebSite.

Sample Code

Example XML Request

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

<request> 
        <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="DeleteCustomerWebSite" impersonate="1"> 
                        <executeData> 
                        <preferredDomainController>AD01.fabrikam.com 
                        </preferredDomainController> 
                        <org>LDAP://OU=northwindtraders,OU=consolidatedmessenger, 
                        OU=Hosting,DC=fabrikam,DC=Com</org> 
                        <webSiteName>NorthWindSupport</webSiteName>   
                        <archiveShare>\\WEB01\archives$\northwindtraders 
                        </webContentArchive> 
                        </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::DeleteCustomerWebSite
Windows-based Hosting::ModifyCustomerWebSite
Windows-based Hosting::ControlCustomerWebSite