Share via

Managed Office Communications Server::DeletePoolAssignment

  • Article

This procedure removes the Office Communication Server pool assignment from the specified organization.

Arguments

Input argument Required Type Description

<organization>

Yes

xs:string

The Lightweight Directory Access Protocol (LDAP) path of the organization.

<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: Customer Administrator

Permission Check

This procedure will perform a test for Customer Administrator (UserCreators).

Business Rules

If there is no pool assigned, no exception will be thrown.

Post-conditions

The pool assignment will be removed.

Sequence Narrative

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

  2. DeletePoolAssignment calls GetPoolOWKGUID_ to retrieve the GUID that identifies the pool assignment owk.

  3. Managed Active Directory:GetOtherWellKnownObject2 is called to retrieve the pool assignment using the OWKGUID from the last call.

  4. Preferred DC Active Directory Provider::SetProperties is called to remove the assignment using the property mode="delete". For example:

    <property name="otherWellKnownObjects" mode="delete"> 
  <value>B:32:F2864B2154204460BC035BDF8A760C45:CN=LC Services,CN=Microsoft,CN=AppPool01,CN=Pools,CN=RTC Service,CN=Microsoft,CN=System,DC=fabrikam,DC=com</value> 
</property>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--LDAP path of the organization--> 
    <organization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</organization> 
    <!--The domain controller to use for Active Directory actions--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
  </data> 
  <procedure> 
    <execute namespace="Managed Office Communications Server" procedure="DeletePoolAssignment" impersonate="1"> 
      <before source="data" sourcePath="organization" destination="executeData" mode="move" /> 
      <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

See also

Tasks

Managed Office Communications Server::SetPoolAssignment
Managed Office Communications Server::GetPoolAssignment