Hosted Mobility 2007 Import::ImportActiveSyncMaiboxPolicies

This procedure imports existing Exchange 2007 Active Sync Mailbox Policies.

The ActiveSync Mailbox Policies imported by this procedure should have the same state as a policy that was created with Hosted Mobility 2007::NewActiveSyncMailboxPolicy.

Arguments

Input arguments	Required	Description
organization	Yes	The Lightweight Directory Access Protocol (LDAP) path of the organization.
preferredDomainController	Yes	The domain controller to use for Active Directory actions.
policies	Yes	The container element for a collection of Active Sync Policy defintions.
policies/ policy	Yes	The container element for a Policy defintion.
policies/ policy/ name	Yes	This parameter specifies the unique name for the policy object. If the policy object exists in Exchange 2007, you must supply the actual name. If, however, you are using this procedure to create a new policy object, the name specified will be created using the name you supply concatenated with an SMTP domain owned by the organization. For example, HumanResources would become HumanResources@AlpineSkiHouse.com.
policies/ policy/ policySettings	No	The container object for mobile policy settings. If the procedure is importing an existing policy then all values contained herein are ignored.
policies/ policy/ policySettings/ allowNonProvisionableDevices	No	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/ policySettings/ allowSimpleDevicePassword	No	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/ policySettings/ alphanumericDevicePasswordRequired	No	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/ policySettings/ attachmentsEnabled	No	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/ policySettings/ deviceEncryptionEnabled	No	This parameter specifies whether device encryption is enabled. If it is set to true, device encryption is enabled.
policies/ policy/ policySettings/ devicePasswordEnabled	No	This parameter specifies whether a device password is enabled. If it is set to true, device password setting is enabled.
policies/ policy/ policySettings/ devicePasswordExpiration	No	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/ policySettings/ devicePasswordHistory	No	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/ policySettings/ maxAttachmentSize	No	This parameter specifies the maximum size of attachments that can be downloaded to the mobile mailbox. The default value is Unlimited.
policies/ policy/ policySettings/ maxDevicePasswordFailedAttempts	No	This parameter specifies the maximum number of failed password attempts a device accepts before it is wiped.
policies/ policy/ policySettings/ maxInactivityTimeDeviceLock	No	This parameter specifies the maximum interval of inactivity before a device locks automatically.
policies/ policy/ policySettings/ minDevicePasswordLength	No	This parameter specifies the minimum length of a device password.
policies/ policy/ policySettings/ passwordRecoveryEnabled	No	False 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/ policySettings/ uncAccessEnabled	No	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/ policySettings/ wssAccessEnabled	No	This parameter specifies whether access to Microsoft Windows SharePoint Services is enabled. Access to specific shares is configured on the Exchange ActiveSync virtual directory.

Remarks

This procedure performs the necessary steps to import existing Exchange 2007 Active Sync Mailbox Policy objects into the MPS System. This includes adding the policy object to the MobilePolicies@<orgname> group and stamping the owningOrganization otherWellKnownObject with the distiguishedName of the organization specified in the <organization> element.

If an existing policy is found to be owned by another organization, the procedure will raise an exception and abort.

Existence of Active Sync Mailbox Policies as Active Directory objects is a new feature of Exchange 2007. This procedure, therefore, also supports the creation of new policies in Exchange 2007 if it does not exist.

The organization specified in the <organization> must be a valid Hosted Messaging and Collaboration version 4.0 organization and must be subscribed to a Hosted Mobility 2007 service plan.

Parameters Format

<executeData> 
  <organization>1..1 </organization>
  <preferredDomainController>1..1 </preferredDomainController>
  <policies>1..1 
		<policy>1..unbounded 
				<name>1..1 </name>
				<policySettings>0..1 
						<allowNonProvisionableDevices>0..1 </allowNonProvisionableDevices>
						<allowSimpleDevicePassword>0..1 </allowSimpleDevicePassword>
						<alphanumericDevicePasswordRequired>0..1 </alphanumericDevicePasswordRequired>
						<attachmentsEnabled>0..1 </attachmentsEnabled>
						<deviceEncryptionEnabled>0..1 </deviceEncryptionEnabled>
						<devicePasswordEnabled>0..1 </devicePasswordEnabled>
						<devicePasswordExpiration>0..1 </devicePasswordExpiration>
						<devicePasswordHistory>0..1 </devicePasswordHistory>
						<maxAttachmentSize>0..1 </maxAttachmentSize>
						<maxDevicePasswordFailedAttempts>0..1 </maxDevicePasswordFailedAttempts>
						<maxInactivityTimeDeviceLock>0..1 </maxInactivityTimeDeviceLock>
						<minDevicePasswordLength>0..1 </minDevicePasswordLength>
						<passwordRecoveryEnabled>0..1 </passwordRecoveryEnabled>
						<uncAccessEnabled>0..1 </uncAccessEnabled>
						<wssAccessEnabled>0..1 </wssAccessEnabled>
				</policySettings>
		</policy>
  </policies>
</executeData>

Returns Format

The return message contains no parameters.

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
		<data> 
				<organization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com </organization>
				<preferredDomainController>AD01.Fabrikam.Com </preferredDomainController>
				<policies> 
						<policy> 
								<name>SalesForce@AlpineSkiHouse.com </name>
								<policySettings> 
										<allowNonProvisionableDevices>1 </allowNonProvisionableDevices>
										<allowSimpleDevicePassword>1 </allowSimpleDevicePassword>
										<alphanumericDevicePasswordRequired>1 </alphanumericDevicePasswordRequired>
										<attachmentsEnabled>1 </attachmentsEnabled>
										<deviceEncryptionEnabled>1 </deviceEncryptionEnabled>
										<devicePasswordEnabled>1 </devicePasswordEnabled>
										<devicePasswordExpiration>5 </devicePasswordExpiration>
										<devicePasswordHistory>10 </devicePasswordHistory>
										<maxAttachmentSize>unlimited </maxAttachmentSize>
										<maxDevicePasswordFailedAttempts>8 </maxDevicePasswordFailedAttempts>
										<maxInactivityTimeDeviceLock>unlimited </maxInactivityTimeDeviceLock>
										<minDevicePasswordLength>4 </minDevicePasswordLength>
										<passwordRecoveryEnabled>1 </passwordRecoveryEnabled>
										<uncAccessEnabled>1 </uncAccessEnabled>
										<wssAccessEnabled>1 </wssAccessEnabled>
								</policySettings>
						</policy>
				</policies>
		</data>
		<procedure> 
				<execute namespace="Hosted Mobility 2007 Import" procedure="ImportActiveSyncMaiboxPolicies" impersonate="1" > 
						<before source="data" destination="executeData" mode="merge" />
						<after source="executeData" destination="data" mode="merge" />
				</execute>
		</procedure>
</request>

Example XML Response

<response> 
		<data />
</response>

Applies To