Hosted Email 2007::Initialize

Use this procedure to initialize the Hosted Email 2007 namespace. The procedure is responsible for registering the service and its types with the Plan Manager database. It will also establish a dependency between this service and Hosted Active Directory.

Arguments

Input Arguments Type Required Description

<preferredDomainController>

string

Yes

The domain controller to use for Active Directory actions.

<hostingOU>

string

No

The parameter specifies the name of the Hosting Organizational Unit. If it is not specified, the default value 'Hosting' is used.

Remarks

Security

The caller must be at least a member of role: DomainAdmin.

Service Registration

The following settings will be used when registering this service with the Plans Manager:

  • serviceId - 299B3A26456B467591DBEED999C84809

  • serviceName - HostedEmail

  • serviceDescription - Hosted Email 2007

Service Types

The service does not define any status types.

Asset Types

The following table shows the asset types registered by this namespace.

Name Code Description

PrimaryDomain

PD

The Primary SMTP Domain for an organization

SecondaryDomain

SD

A secondary SMTP Domain for an organization

VanityDomain

CD

A Consumer User Vanity Domain

ExchMailboxGUID

EG

A user's Exchange Mailbox GUID

Plan Types

The following table shows the plan types registered by this namespace.

Name Code Description

ExchOrgHosting

EB

An Exchange Hosting plan for a business organization

ExchUserHosting

EU

An Exchange Hosting plan for a business or consumer user

Event Types

The following table shows the event types registered by this namespace.

Name Code Description

AddressListsCreated

AL

Exchange address lists added to the organization

PublicFolderCreated

PF

Exchange public folder added to the organization

PublicFolderDeleted

FD

Exchange public folder deleted for the organization

AddressListsDeleted

LD

Exchange address lists deleted for an organization

MailboxCreated

MC

Mailbox created

MailboxDeleted

MD

Mailbox deleted

MailEnableContact

CE

Contact mail enabled

MailDisableContact

CD

Contact mail disabled

MailEnableGroup

GE

Group mail enabled

MailDisableGroup

GD

Group mail disabled

MailboxModify

MM

Mailbox modified

FolderModify

FM

Public Folder modified

Feature Types

See Hosted Email 2007::CreateUserPlan and Hosted Email 2007::CreateOrganizationPlan.

Schema Definition

Input

<executeData>  
        <preferredDomainController>1..1 </preferredDomainController> 
        <hostingOU>0..1 </hostingOU> 
</executeData> 

Output

<executeData> 1..1 </executeData> 

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--Specifies the name of the Hosting Organizational Unit. If not specified a default value of 'Hosting' is used.--> 
    <hostingOU>Hosting</hostingOU> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="Initialize" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="hostingOU" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response>  
        <data /> 
</response> 

Applies To

Hosted Email 2007 Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

Hosted Email 2007::AddAvailablePlans
Hosted Email 2007::GetUserPlanAssignment
Hosted Email 2007::CreateOrganizationPlan
Hosted Email 2007::CreateUserPlan
Hosted Email 2007::GetOrganizationAvailablePlans
Hosted Email 2007::GetOrganizationPlan
Hosted Email 2007::GetUserPlanAssignment
Hosted Email 2007::GetUserPlan
Hosted Email 2007::GetServiceInformation
Hosted Email 2007::GetUserPlanAssignment
Hosted Email 2007::ModifyOrganizationPlan
Hosted Email 2007::ModifyUserPlan
Hosted Email 2007::RemoveAvailablePlans
Hosted Email 2007::Subscribe
Hosted Email 2007::Unsubscribe