Unified Messaging 2007 Provider::SetUMMailboxPIN

This procedure sets the users mailbox PIN and certain other related properties.

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. Note 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.
<notifyEmail >	No	The e-mail address where notifications are to be sent.
<pin>	No	The 4 to 24 digit pass code to the users mailbox.
<pinExpired >	No	If it is set to true, the process forces the user to set a new pin when they log in.
<lockedOut >	No	If the value is set to false, unlock an account.

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='SetUMMailboxPIN'> 
                        <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