Managed Office Communications Server::GetSipUserProperties
This procedure retrieves the properties of an Office Communications Server user.
Arguments
Input argument | Required | Type | Description |
---|---|---|---|
<user> |
Yes |
xs:string |
The Lightweight Directory Access Protocol (LDAP) path of the user. |
<preferredDomainController> |
Yes |
xs:string |
The domain controller to use for Active Directory actions. |
Output argument | Type | Description |
---|---|---|
<enabled> |
xs:boolean |
If true, this user is authorized for; if false, the user does not have specific support under SIP. |
<enabledForEnhancedPresence> |
xs:boolean |
If true, the user is enabled for enhanced presence. If false, the user is not enabled for enhanced presence. The default is false. |
<enabledForFederation> |
xs:boolean |
If true, the user is enabled for federation. If false, the user is not enabled for federation. The default is false. |
<enabledForInternetAccess> |
xs:boolean |
If true, the user is enabled for Internet access. If false, the user is not enabled for Internet access. The default is false. |
<homeServerDN> |
xs:string |
The distinguished name of the home server for this user. This name must be valid within the domain's Active Directory. The value of this property is not case-sensitive. This value cannot be NULL. |
<instanceID> |
xs:string |
A GUID value that uniquely identifies an instance of this class. |
<primaryURI> |
xs:string |
The primary SIP URI of the user. This URI must be unique and must be represented in the form "sip:user@domain" where the domain substring is either a fully qualified domain name or a valid IP address. Domains cannot be 0.0.0.0 or any multicast domain address from 224.0.0.0 to 239.255.255.255. |
<publicNetworkEnabled> |
xs:boolean |
This parameter controls whether the user is able to exchange instant messages with other users who are hosted by one or more public IM service providers. If true, the user is authorized for public IM connectivity. If false, the user not authorized for public IM connectivity. The default is false. |
<targetServerDNIfMoving> |
xs:string |
The distinguished name of the target server to which the Active Directory user object is moving, if a user move is in progress. |
<userCategory> |
xs:string |
This parameter indicates whether the user is represented in Active Directory by a User object or a Contact object. |
<userDN> |
xs:string |
The distinguished name of the corresponding Active Directory user object for this user. |
<allowOrganizeMeetingWithAnonymousParticipants> |
xs:boolean |
If true, the user is allowed to invite anonymous user to meeting. |
<meetingPolicy> |
xs:string |
The name of the Meeting Policy to be applied to a user. |
<ucEnabled> |
xs:boolean |
If true, the user is enabled for Unified Communications. |
<ucPolicy> |
xs:string |
The name of the Unified Communications Policy to be applied to a user. |
<archiveFederatedCommunications> |
xs:boolean |
This parameter controls whether a user's communications across federated domains are archived. |
<archiveInternalCommunications> |
xs:boolean |
This parameter controls whether a user's communications within their internal domain are archived. |
<ipPBXSoftPhoneRoutingEnabled> |
xs:boolean |
This parameter controls whether the user is enabled for both remote call control and Enterprise voice. Requires that the UCEnabled be set to true. |
<lineServerURI> |
xs:string |
The SIP URI of the telephony gateway server assigned to this user for remote-call control (RCC). A valid SIP URI uses the following form: Sip:abc@pbx1.phones.microsoft.com. This property is not indexed, but is marked for global container replication. If RemoteCallControlTelephoneyEnabled is true, then this value cannot be NULL. The value of this property is not case-sensitive. The maximum length of the string is 454 characters. |
<lineURI> |
xs:string |
Either the SIP URI or the Tel. URI of the user's phone line. This value is used by the Microsoft Office Communicator client and by Enterprise Voice for call routing. A valid SIP URI uses the following form: sip:+14257777777@phones.fabrikam.com;user=phone. This SIP URI value must be unique. A valid Tel. URI uses the following form: tel:+14257071111;ext=71111;attribute=telephone number. This property is indexed and marked for global container replication. If RemoteCallControlTelephoneyEnabled is true, then this value cannot be NULL. The value of this property is not case-sensitive. The maximum length of the string is 454 characters. |
<remoteCallControlTelephonyEnabled> |
xs:boolean |
This parameter controls whether the user is able to use the Microsoft Office Communicator client in combination with the user's computer to initiate, receive, and forward phone calls. If true, the user is authorized for remote call control. If false, the user is not authorized for remote call control. If the value is true, LineURI and LineServerURI cannot be null. The default value is false. |
<contactType> |
xs:string |
When the <UserCategory> property is set to contact, <ContactType> specifies whether the contact is an auto attendant (AA) or a normal (default) contact. Possible values: "default": The contact is a normal contact. "AA": The contact is an auto attendant. Type: xs:string |
<displayName> |
xs:string |
The display name for this user as registered on the home server. This value is the actual display name of the user as specified in Active Directory. |
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).
Preconditions
The user exists in Office Communications Server.
Post-conditions
The properties of the user will be retrieved.
Sequence Narrative
Actor submits GetSipUserProperties request to the Managed Office Communications Server namespace.
The Managed Office Communications Server namespace transforms the user's LDAP path to DN using the private internal procedure LDAPtoDN_.
The Managed Office Communications Server namespace calls Office Communcations Server Provider::GetSipUserProperties.
The Managed Office Communications Server namespace calls the Office Communcations Server Provider::GetMeetingPolicyNameByDN procedure if meetingPolicy is returned from Office Communications Server Provider.
The Managed Office Communications Server namespace calls the Office Communcations Server Provider::GetUCPolicyNameByDN if ucPolicy is returned from Office Communications Server Provider.
Sample Code
Example XML Request
<request>
<data>
<!--LDAP path of the user-->
<user>LDAP://CN=JohnC@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user>
<!--The domain controller to use for Active Directory actions-->
<preferredDomainController>AD01.Fabrikam.Com</preferredDomainController>
</data>
<procedure>
<execute namespace="Managed Office Communications Server" procedure="GetSipUserProperties" impersonate="1">
<before source="data" sourcePath="user" 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>
<!--This allows the user to invite anonymous user to meeting.-->
<allowOrganizeMeetingWithAnonymousParticipants>true</allowOrganizeMeetingWithAnonymousParticipants>
<!--Controls whether a user's communications across federated domains are archived.-->
<archiveFederatedCommunications>true</archiveFederatedCommunications>
<!--Controls whether a user's communications within their internal domain are archived.-->
<archiveInternalCommunications>true</archiveInternalCommunications>
<!--When the UserCategory property is set to contact, ContactType specifies whether the contact is an auto attendant (AA) or a normal (default) contact.-->
<contactType>default</contactType>
<!--The display name for this user as registered on the home server. This value is the actual display name of the user as specified in Active Directory.-->
<displayName>John Chen</displayName>
<!--If true, this user is authorized for; if false, the user does not have specific support under SIP-->
<enabled>true</enabled>
<!--If true the user is enabled for enhanced presence. If false the user is not enabled for enhanced presence. The default is false-->
<enabledForEnhancedPresence>false</enabledForEnhancedPresence>
<!--If true the user is enabled for federation. If false the user is not enabled for federation. The default is false-->
<enabledForFederation>false</enabledForFederation>
<!--If true the user is enabled for Internet access. If false the user is not enabled for Internet access. The default is false-->
<enabledForInternetAccess>false</enabledForInternetAccess>
<!--The distinguished name of the home server for this user. This name must be valid within the domain's Active Directory. The value of this property is not case-sensitive. This value cannot be NULL-->
<homeServerDN>CN=LC Services,CN=Microsoft,CN=pool,CN=Pools,CN=RTC Service,CN=Microsoft,CN=System,DC=fabrikam,DC=com</homeServerDN>
<!--A GUID value that uniquely identifies an instance of this class-->
<instanceID>{01234567-0123-4567-89AB-CDEF0123456}</instanceID>
<!--Controls whether the user is enabled for both remote call control and Enterprise voice. Requires that the UCEnabled be set to true.-->
<ipPBXSoftPhoneRoutingEnabled>false</ipPBXSoftPhoneRoutingEnabled>
<!--The SIP URI of the telephony gateway server assigned to this user for remote-call control (RCC).-->
<lineServerURI>sip:server01@pbx1.phones.fabrikam.com</lineServerURI>
<!--Either the SIP URI or the Tel. URI of the user's phone line. This value is used by the Microsoft Office Communicator client and by Enterprise Voice for call routing.-->
<lineURI>tel:+15555550101</lineURI>
<!--Specifies the name of the Meeting Policy to be applied to a user.-->
<meetingPolicy>Default Policy</meetingPolicy>
<!--The primary SIP URI of the user. This URI must be unique and must be represented in the form "sip:user@domain" where the domain substring is either a fully qualified domain name or a valid IP address. Domains cannot be 0.0.0.0 or any multicast domain address from 224.0.0.0 to 239.255.255.255-->
<primaryURI>SIP:JohnC@AlpineSkihouse.com</primaryURI>
<!--Controls whether the user is able to exchange instant messages with other users who are hosted by one or more public IM service providers. If true, the user is authorized for public IM connectivity. If false, the user not authorized for public IM connectivity. The default is false-->
<publicNetworkEnabled>false</publicNetworkEnabled>
<!--Controls whether the user is able to use the Microsoft Office Communicator client in combination with the user's computer to initiate, receive, and forward phone calls.-->
<remoteCallControlTelephonyEnabled>true</remoteCallControlTelephonyEnabled>
<!--The distinguished name of the target server to which the Active Directory user object is moving, if a user move is in progress-->
<targetServerDNIfMoving>CN=LC Services,CN=Microsoft,CN=pool2,CN=Pools,CN=RTC Service,CN=Microsoft,CN=System,DC=fabrikam,DC=com</targetServerDNIfMoving>
<!--This enables the user for Unified Communications.-->
<ucEnabled>true</ucEnabled>
<!--Specifies the name of the Unified Communications Policy to be applied to a user. This parameter must be present if ucEnabled is true.-->
<ucPolicy>Default Policy</ucPolicy>
<!--Indicates whether the user is represented in Active Directory by a User object or a Contact object-->
<userCategory>user</userCategory>
<!--The distinguished name of the corresponding Active Directory user object for this user-->
<userDN>CN=JohnC@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</userDN>
</data>
</response>
Applies To
Managed Office Communications Server Namespace API for:
- Hosted Messaging and Collaboration version 4.5