Unified Messaging 2007 Provider::EnableUMMailbox

This procedure enables a users mailbox for Unified Messaging (UM).

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 AD Object path, GUID, DN, Domain/SamAccountName, UPN, LegacyExchangeDN, SMTPAddress or Alias. Note sAMAccountName cannot be longer than 20 characters. See SAM-Account-Name Attribute for more information.
<umMailboxPolicy>	Yes	The mailbox policy that sets associated with the mailbox.
<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.
<extensions>	No	The container node for one or more extension nodes
<automaticSpeechRecognitionEnabled>	No	This parameter specifies whether user can use speech recognition.
<notifyEmail>	No	The e-mail address where notifications are to be sent.
<pilotNumber>	No	This is the number the user will use to access their mailbox.
<pin>	No	The 2 to 24 digit pass code to the users mailbox.
<pinExpired>	No	If it is set to true, system forces the user to set a new pin when they log in.
<sipResourceIdentifier>	No	This specifies the SIP address for the user.
<validateOnly>	No	If it is set to true, the process will only check to ensure the prerequisites have been met to successfully UM enable the user.

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='EnableUMMailbox'> 
                        <executeData> 
                                <identity>Fabrikam\user1</indentity> 
                                <umMailboxPolicy>PolicyID</umMailboxPolicy>  
                                <preferredDomainController>dc01.fabrikam.local</preferredDomainController> 
                                <extensions > 
                                        <extension>5551212</extension> 
                                        <extension>5551213</extension> 
                                </extensions> 
                                <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