Unified Messaging 2007 Provider::SetUMMailboxPolicy

  • Article

This procedure sets the properties for a mailbox policy.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<identity>

Yes

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

Dd279071.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.

<allowCommonPatterns >

No

This parameter specifies whether to allow obvious PINs. For example, subsets of the telephone number, sequential numbers, or repeated numbers

<allowDialPlanSubscribers>

No

This parameter specifies whether to let subscribers in a dial plan dial a number that resolves to another subscriber within the same dial plan. The default is $true.

<allowedInCountryGroups >

No

The parent Container for countryGroup's nodes

<inCountryGroup>

No

This parameter specifies the list of in-country/region dial group names that are allowed.

<allowedInternationalGroups>

No

The parent container for internationalGroup's nodes

<internationalGroup>

No

This parameter specifies the list of international dial group names that are allowed.

<allowExtensions>

No

This parameter specifies whether callers can make calls to extensions that have the same number of digits as the number that is specified on the dial plan object.

<allowMissedCallNotifications>

No

This parameter specifies if missed call notifications will be enabled for users who are associated with the UM mailbox policy.

<faxID>

No

This parameter specifies the fax identifier.

<faxMessageText>

No

This parameter specifies text that will be included in the body of a fax..

<logonFailuresBeforePINReset>

No

This parameter specifies the number of sequential unsuccessful logon attempts before the mailbox PIN is automatically reset. To disable this feature, set this parameter to Unlimited. If this parameter is not set to Unlimited, it must be set to less than MaxLogonAttempts. The range is 0 to 999. The default setting is 5

<maxGreetingDuration>

No

The maximum length of a greeting in minutes, range 1 to 10

<maxLogonAttempts>

No

This parameter specifies the number of times a user can try unsuccessfully to log on, in sequence, before the UM mailbox is locked. The range is 1 to 999. The default is 15.

<minPINLength>

No

The minimum number of digits a PIN must contain. It ranges from 4 to 24. the default value is 6.

<name>

No

This parameter sets the name if the IP Gateway object

<pinHistoryCount>

No

This parameter specifies the number of previous PINs that will be remembered and will not be allowed during a PIN reset. This number includes the first time that the PIN was set. The range is 1 to 20. The default is 5.

<pinLifeTime>

No

This parameter specifies the number of days until a new password is required. The range is 1 to 999. The default is 60. If you specify Unlimited, the users' PIN will not expire.

<resetPINText>

No

The text to be included in a PIN reset request email. 512 Characters max.

<umDialPlan>

No

The dial plan to be used with the mailbox policy

<umEnabledText>

No

This parameter specifies the text to be included in the UM-enabled e-mail message. This text is limited to 512 characters.

<voiceMailText>

No

This parameter specifies the text to be included in the body part of voice messages. The parameter applies to call answering messages in addition to messages that are originated by an authenticated subscriber. This text is limited to 512 characters.

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='SetUMMailboxPolicy'> 
                        <executeData> 
                                <identity>mailboxpolicy1</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