Share via


Managed Office Communications Server::Initialize

This procedure initializes the Managed Office Communications Server namespace.

Arguments

Input argument Required Type Description

<preferredDomainController>

Yes

xs:string

The domain controller to use for Active Directory actions.

Remarks

Security

The caller must be at least a member of role: DomainAdmins

Permission Check

This procedure will perform a test for Domain Administrators (DomainAdmins).

Preconditions

Managed Office Communications Server has been installed.

Business Rules

The procedure must be able to be run multiple times without producing an exception.

Post-conditions

The MPFServiceAcct account is added to the RTCUniversalServerAdmins group.

Sequence Narrative

  1. Actor submits Initialize request to the Managed Office Communications Server namespace.

  2. Try: The MPFServiceAccts group is added to the RTCUniversalServerAdmins group.

  3. Catch: If an error occurs in the above step and it is not because the group is already a member, the error is suppressed using Managed Active Directory::RethrowError_.

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The domain controller to use for Active Directory actions--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
  </data> 
  <procedure> 
    <execute namespace="Managed Office Communications Server" procedure="Initialize" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response>  
   <data /> 
</response>

Applies To

Managed Office Communications Server Namespace API for:

  • Hosted Messaging and Collaboration version 4.5