Unified Messaging 2007 Provider::SetUMMailbox

This procedure sets one or more of the Unified Messaging (UM) related properties of a UM enabled mailbox.

These properties are stored either in Active Directory in the user object or in the mailbox object in Exchange.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<identity>

Yes

The identifier for the user. This can be in the form of a Active Directory Object path, GUID, DN, Domain/SamAccountName, UPN, LegacyExchangeDN, SMTPAddress or Alias.

Dd251681.note(en-us,TechNet.10).gifNote
sAMAccountName cannot be longer than 20 characters. See SAM-Account-Name Attribute for more information.

<propertyList >

Yes

The container for the list of properties.

<property >

Yes

The container for one or more properties to be set.

<Name>

Yes

The attribute of property node to define the property name the value is being set for.

<Value >

Yes

The property node may contain one or more value nodes to enter 1 or an array of values.

<allowUMCallsFromNonUsers>

No

This parameter specifies whether a mailbox will be included in directory searches.

<anonymousCallersCanLeaveMessages>

No

This parameter specifies whether calls with no Caller ID can leave messages.

<automaticSpeechRecognitionEnabled>

No

This parameter specifies whether user can use speech recognition.

<callAnsweringAudioCodec>

No

This parameter specifies which audio codec is used for answering calls.

<displayName>

No

The display name of the user.

<faxEnabled>

No

The account is enabled to receive faxes

<missedCallNotificationEnabled>

No

This parameter specifies if missed call notifications will be sent

<name>

No

The user name with maximum 64 characters.

<operatorNumber>

No

This parameter specifies the digits to reach a personal operator.

<subscriberAccessEnabled>

No

This parameter enables users access to their voice mailbox box.

<tuiAccessToAddressBookEnabled>

No

If this parameter is set true, user can access their address book by phone

<tuiAccessToCalendarEnabled>

No

If this parameter is set true, user can access their calendar by phone.

<tuiAccessToEmailEnabled>

No

If this parameter is set true, user can access their email by phone.

<umMailboxPolicy>

No

The mailbox policy

Remarks

Security

The caller must be at least a member of role: UserCreators.

Sample Code

Example XML Request

<request> 
        <data/> 
        <procedure> 
                <execute namespace=' Unified Messaging 2007 Provider' procedure='SetUMMailbox'> 
                        <executeData> 
                                <identity>Fabrikam\user1</indentity> 
                                <preferredDomainController>dc01.fabrikam.local</preferredDomainController> 
                                <propertyList> 
                                        <property name="propertyName"> 
                                                <value>return value</value> 
                                                . 
                                        </property> 
                                                . 
                                </ propertyList> 
                        </executeData> 
                </execute> 
        </procedure> 
</request> 

Applies To

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0