Hosted CDI::ModifyOrganization
The ModifyOrganization procedure modifies the Customer Directory Integration (CDI) settings for a customer organization.
This procedure calls the methods of the Managed CDI Namespace to make updates in the Active Directory. These method calls remain unchanged. Calls currently made to Managed Helpers to update the Plans Database are replaced by appropriate calls to Managed Customer Plans Namespace.
Arguments
Input argument | Required | Description |
---|---|---|
<path> |
Yes |
The Lightweight Directory Access Protocol (LDAP) path of the customer organization in the Service Provider domain |
<preferredDomainController> |
Yes |
The name of the preferred domain controller in the Service Provider domain |
<remoteFQDNDomainName> |
Yes |
The fully qualified domain name of the customer's remote domain |
<remoteNetBiosDomainName> |
No |
The NetBIOS name of the customer's remote domain |
<newRemoteFQDNDomainName> |
No |
The new fully qualified domain name of the remote domain if you wish to change it |
<remotePreferredDomainController> |
No |
The name of the customer's remote preferred domain controller |
<remoteAdministratorContact> |
No |
The e-mail address of the customer's remote administrator contact |
Remarks
Updates to Plans Database
The following methods of the Managed Helpers Namespace are currently called to create and update entries in tables of the Plans Database:
CreateAssetPropertyRecord_
ModifyAssetRecord_
LogEventRecord_
Managed Customer Plans Namespace APIs
This section lists the Managed Customer Plans APIs that will be called internally by the ModifyOrganization procedure.
SN | Plans DB Action | Managed Customer Plans API |
---|---|---|
1 |
Create Asset Property Record |
CreateAssetProperty |
2 |
Modify Asset Record |
ModifyCustomerAsset |
3 |
Log Event Record |
LogEvent |
Internal Calls Made By the Procedure
The following graph describes the internal calls made by the procedure.
Insert Image: CMSU_Graphics_CDI_ModifyOrganization_Calls_to_APIs_of_Managed_CDI_and_Managed_Customer_Plans.JPEG
Sample Code
Example XML Request
The following is an example of an input XML request for the ModifyOrganization procedure of the Hosted CDI Namespace:
<request>
<procedure>
<execute namespace="Hosted CDI" procedure="ModifyOrganization" impersonate="1">
<executeData>
<path>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger, OU=Hosting,DC=Fabrikam,DC=Com</path>
<remoteNetBiosDomainName>Alpine</remoteNetBiosDomainName>
<remoteFQDNDomainName>Alpine.com</remoteFQDNDomainName>
<remotePreferredDomainController>AlpineAD.Alpine.com</remotePreferredDomainController>
<remoteAdministratorContact>admin@Alpine.com</remoteAdministratorContact>
<preferredDomainController>ad0l.fabrikam.com</preferredDomainController>
</executeData>
<after source="executeData" destination="data" mode="merge"/>
</execute>
</procedure>
</request>
Applies To
Hosted Customer Directory Integration Namespace API for:
Hosted Messaging and Collaboration version 4.0
Hosted Messaging and Collaboration version 3.5
Windows-based Hosting version 4.5
Windows-based Hosting version 4.0
Windows-based Hosting for Applications version 1.0
See also
Tasks
Hosted CDI::GetOrganizationSettings
Hosted CDI::EnableOrganization
Hosted CDI::DisableOrganization