Managed Live Communications::EnableUser

  • Article

The EnableUser procedure enables a user object for Live Communications Server 2005.

Arguments

Input argument Required Description

<path>

Yes

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

<preferredDomainController>

Yes

The name of the preferred domain controller. This parameter must exist, although it can be empty. It is highly recommended to include accurate data in this parameter.

<homeServerPool>

Yes

The distinguished name (DN) of the user's Live Communications Server 2005 home server pool. This parameter must exist, although it can be empty. However, if it is empty, the user is not assigned to an Live Communications Server home server and will not be able to utilize Live Communications Server capabilities until they are. It is highly recommended to include data in this parameter to ensure proper provisioning into Live Communications Server.

<msRTCSIP-FederationEnabled>

No

Controls whether a single user is enabled for Federation. Valid values are TRUE or FALSE. Note that these values are case-sensitive.

<msRTCSIP-InternetAccessEnabled>

No

Controls whether a single user is enabled for outside user access. Valid values are TRUE or FALSE. Note that these values are case-sensitive.

<msRTCSIP-ArchivingEnabled>

No

Controls whether a single user's communications are to be archived. Valid values are:

  • 0 = use the global default values defined by: msRTCSIP-ArchiveDefault and msRTCSIP-ArchiveFederation.

  • 1 = Archive all communications.

  • 2 = Do not archive.

  • 3 = Archive all communications without message body.

Remarks

Security

The EnableUser procedure has the following security requirements:

  • The caller is impersonated.

Sample Code

Example XML Request

The following is an example of an XML request for the EnableUser procedure of the Managed Live Communication Namespace:

<request> 
        <procedure> 
                <execute namespace="Managed Live Communications"  
                 procedure="EnableUser" impersonate="1"> 
                        <executeData> 
                        <path>LDAP://CN=jimc@alpineskihouse.com,OU=alpineskihouse, 
                         OU=consolidatedmessenger,OU=Hosting,DC=fabrikam,DC=Com</path> 
                        <preferredDomainController>AD01.fabrikam.COM 
                        </preferredDomainController> 
                        <homeServerPool>[pool DN]</homeServerPool> 
                        <msRTCSIP-FederationEnabled>TRUE</msRTCSIP-FederationEnabled> 
                        <msRTCSIP-InternetAccessEnabled>FALSE 
                        </msRTCSIP-internetAccessEnabled> 
                        <msRTCSIP-ArchivingEnabled>1</msRTCSIP-archivingEnabled> 
        </executeData> 
                <after source="executeData" destination="data" mode="merge"/> 
                </execute> 
        </procedure> 
</request>

Example XML Response

No example XML response.

Applies To

Managed Live Communications Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

See also

Tasks

Managed Live Communications::DisableUser
Managed Live Communications::ModifyUser