Exchange 2007 Mobility Provider::GetActiveSyncMailboxPolicy

  • Article

This procedure returns mailbox policies.

Arguments

Input argument Required Description

<preferredDomainController>

Yes

The name of the preferred domain controller.

<identity>

No

The policy name.
Output argument Description

policies

The list of mailbox policies.

policies/ policy

List of a policy.

policies/ policy/ allowNonProvisionableDevices

This parameter specifies whether devices that cannot be provisioned automatically are allowed. If set to true, the policy allows devices that cannot be provisioned automatically.

policies/ policy/ allowSimpleDevicePassword

This parameter specifies whether a simple device password is permitted. A simple device password is one in which there is a specific pattern, such as 1111 or 1234.

policies/ policy/ alphanumericDevicePasswordRequired

This parameter specifies whether the device password must contain non-numeric characters. If set to true, the device password must contain non-numeric characters.

policies/ policy/ attachmentsEnabled

This parameter specifies whether attachments can be downloaded to the device. If it is set to true, attachments are downloaded to the device.

policies/ policy/ deviceEncryptionEnabled

This parameter specifies whether device encryption is enabled. If it is set to true, device encryption is enabled.

policies/ policy/ devicePasswordEnabled

This parameter specifies whether a device password is enabled. If it is set to true, device password setting is enabled.

policies/ policy/ devicePasswordExpiration

This parameter specifies the length of time, in days, that a password can be used. After this length of time, a new password must be created.

policies/ policy/ devicePasswordHistory

This parameter specifies the number of previously used passwords to store. When a user creates a new password, they cannot reuse a stored password that was previously used.

policies/ policy/ devicePolicyRefreshInterval

This parameter specifies how often the device policy is refreshed.

policies/ policy/ maxAttachmentSize

This parameter specifies the maximum size of attachments that can be downloaded to the mobile mailbox. The default value is Unlimited.

policies/ policy/ maxDevicePasswordFailedAttempts

This parameter specifies the maximum number of failed password attempts a device accepts before it is wiped.

policies/ policy/ maxInactivityTimeDeviceLock

This parameter specifies the maximum interval of inactivity before a device locks automatically.

policies/ policy/ minDevicePasswordLength

This parameter specifies the minimum length of a device password.

policies/ policy/ passwordRecoveryEnabled

This parameter enables the administrator to store the recovery password on Exchange. The recovery password can be viewed from Office Outlook Web Access or the Exchange Management Console.

policies/ policy/ name

This parameter specifies the name of the mailbox policy.

policies/ policy/ uncAccessEnabled

This parameter specifies whether access to Windows file shares is enabled. Access to specific shares is configured on the Exchange ActiveSync virtual directory.

policies/ policy/ wssAccessEnabled

This parameter specifies whether access to Microsoft Windows SharePoint Services is enabled. Access to specific shares is configured on the Exchange ActiveSync virtual directory.

policies/ policy/ GUID

The GUID of the object.

policies/ policy/ distinguishedName

The distinguished name of the object.

Remarks

No remarks.

Sample Code

Example XML Request

<request>  
   <data>  
      <preferredDomainController>ad01.fabrikam.com </preferredDomainController> 
   </data> 
   <procedure>  
      <execute namespace="Exchange 2007 Mobility Provider" procedure="GetActiveSyncMailboxPolicy" impersonate="1" >  
         <before source="data" destination="executeData" mode="merge" /> 
         <after source="executeData" destination="data" mode="merge" /> 
      </execute> 
   </procedure> 
</request>

Example XML Response

<response>  
   <data>  
      <policies>  
         <policy>  
            <allowNonProvisionableDevices>true </allowNonProvisionableDevices> 
            <allowSimpleDevicePassword>true </allowSimpleDevicePassword> 
            <alphanumericDevicePasswordRequired>true </alphanumericDevicePasswordRequired> 
            <attachmentsEnabled>true </attachmentsEnabled> 
            <deviceEncryptionEnabled>true </deviceEncryptionEnabled> 
            <devicePasswordEnabled>true </devicePasswordEnabled> 
            <devicePasswordExpiration>5 </devicePasswordExpiration> 
            <devicePasswordHistory>10 </devicePasswordHistory> 
            <devicePolicyRefreshInterval>5 </devicePolicyRefreshInterval> 
            <maxAttachmentSize>unlimited </maxAttachmentSize> 
            <maxDevicePasswordFailedAttempts>8 </maxDevicePasswordFailedAttempts> 
            <maxInactivityTimeDeviceLock>unlimited </maxInactivityTimeDeviceLock> 
            <minDevicePasswordLength>4 </minDevicePasswordLength> 
            <passwordRecoveryEnabled>true </passwordRecoveryEnabled> 
            <name>SalesPolicy </name> 
            <uncAccessEnabled>true </uncAccessEnabled> 
            <wssAccessEnabled>true </wssAccessEnabled> 
            <GUID>8e367b75-a31c-451f-84dd-143e2dd5dec9 </GUID> 
            <distinguishedName&gt;CN=SalesPolicy,CN=Mobile Mailbox Policies,CN=Fabrikam,CN=Microsoft Exchange, 
            CN=Services,CN=Configuration,DC=fabrikam,DC=com </distinguishedName> 
         </policy> 
      </policies> 
   </data> 
</response>

Applies To

Exchange 2007 Mobility Provider API for

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0