Hosted Unified Messaging::UnSubscribe
This procedure removes the Unified Messaging plan from the specified organization.
This procedure for Hosted Messaging and Collaboration version 4.5 is updated to accept a GUID as an override to the path parameter as well as to make planName an optional parameter. The procedure instead looks up the Plan assignment for the organization based on the organization GUID.
Arguments
Input Arguments for Hosted Messaging and Collaboration version 4.0
Input Arguments | Type | Required | Description |
---|---|---|---|
<Path> |
string |
Yes |
The Lightweight Directory Access Protocol (LDAP) path of a organization object. |
<preferredDomainController> |
string |
Yes |
The domain controller to use for Active Directory (AD) actions. |
Input Arguments for Hosted Messaging and Collaboration version 4.5
Input Arguments | Type | Required | Description |
---|---|---|---|
<GUID> |
string |
Yes if <organization> is not specified |
The GUID of the organization to unsubscribe. |
<organization> |
string |
Yes if <GUID> is not specified |
The LDAP path of the organization to query in Resource Manager (RM). GUID should only be specified when the organization object is no longer found in Active Directory. That is, Organization has been orphaned. |
<planName> |
string |
No |
Organization plan to unsubscribe from. If it is not supplied, the procedure will look up the appropriate plan based on GUID or organization. |
<preferredDomainController> |
string |
Yes |
Required parameter. The domain controller to use for Active Directory operations. Use the fully qualified domain name (FQDN) of the domain controller that you want to use. |
Output arguments
A successful request will mirror the input data.
Remarks
Notes
When a GUID is supplied, this procedure must assume that the Organization as well as the child objects do not exist in Active Directory. If a GUID is supplied, the procedure avoids any calls to Active Directory.
You can not unsubscribe an organization if it has unified messaging enabled mailboxes.
Security
If organization is specified, existing test for userCreators.
If GUID is specified, this procedure must test for more restrictive DomainAdmins.
Error Handling
Error Condition | Error Text |
---|---|
Neither GUID nor path specified |
You must supply either a <GUID> or <path> element. |
Active Directory object referenced by GUID exists. |
The object with GUID %GUID% was found in Active Directory. This GUID parameter should only be used when the corresponding Active Directory object has been deleted. |
Sample Code
Example XML Request 1
<request>
<procedure>
<execute namespace="Hosted Unified Messaging" procedure="Unsubscribe" impersonate="1">
<executeData>
<preferredDomainController>ad01.fabrikam.com</preferredDomainController>
<path>LDAP://OU=Alpineskihouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</path>
</executeData>
<after source="executeData" destination="data" />
</execute>
</procedure>
</request>
Example XML Request 2
<request>
<data>
<preferredDomainController>AD01.Fabrikam.Com</preferredDomainController>
<GUID>3459316ef1b043439a0ac9de3ee90eef</GUID>
<planName>PlatinumUMHosting</planName>
</data>
<procedure>
<execute namespace="Hosted Unified Messaging" procedure="Unsubscribe" impersonate="1">
<before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" />
<before source="data" sourcePath="GUID" destination="executeData" mode="move" />
<before source="data" sourcePath="planName" destination="executeData" mode="move" />
<after source="executeData" destination="data" mode="merge" />
</execute>
</procedure>
</request>
Example XML Response
<response>
<data>
<preferredDomainController>AD01.Fabrikam.Com</preferredDomainController>
<GUID>3459316ef1b043439a0ac9de3ee90eef</GUID>
<planName>PlatinumUMHosting</planName>
</data>
</response>
Applies To
Hosted Unified Messaging Namespace for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0