Hosted Email 2007::ModifyResourceMailbox

This procedure modifies the attributes of a resource mailbox in Exchange server.

Input Arguments	Required	Type	Description
<preferredDomainController>	Yes	string	The domain controller to use for Active Directory actions.
<user>	Yes	string	The Lightweight Directory Access Protocol (LDAP) path of the user object for which the mailbox will be modified.
<alias>	No	string	The e-mail alias of the mailbox that you are modifying. The alias can be a combination of characters separated by a period with no intervening spaces. Do not use special characters in the alias.
<emailAddresses>	No	complexType	This parameter specifies the proxy addresses of the mailbox. The primary Simple Mail Transfer Protocol (SMTP) address is the first in the list of proxy addresses.
<emailAddresses>/<value >	No	string	SMTP proxy address.
<resourceCapacity>	No	nonNegativeInteger	This parameter specifies the capacity of the resource.
<automateProcessing>	No	Enum	This parameter specifies the automate calendar processing behaviors on the mailbox. None - Both resource booking and the Calendar Attendant will be disabled. AutoUpdate - The Calendar Attendant will process meeting requests and responses. AutoAccept - Both Calendar Attendant and resource booking will be enabled.
<allBookInPolicy>	No	boolean	This parameter specifies whether to automatically approve in-policy requests from all users.
<allRequestInPolicy>	No	boolean	This parameter specifies whether to allow all users to submit in-policy requests.
<allRequestOutOfPolicy>	No	boolean	This parameter specifies whether to allow all users to submit out-of-policy requests. Out-of-policy requests are subject to approval by a resource mailbox delegate.
<bookInPolicy>	No	complexType	This parameter specifies a list of users who are allowed to submit in-policy meeting requests to the resource mailbox. Any in-policy meeting requests from these users will automatically be approved.
<bookInPolicy>/<recipientId>	No	string	This parameter specifies the ID of a recipient in the list.
<forwardRequestsToDelegates>	No	boolean	This parameter specifies whether to forward incoming meeting requests to the delegates defined for the mailbox.
<requestInPolicy>	No	complexType	This parameter specifies a list of users who are allowed to submit in-policy meeting requests to the resource mailbox. All in-policy meeting requests from these users will be subject to approval by a resource mailbox delegate.
<requestInPolicy>/<recipientId>	No	string	This parameter specifies the ID of a recipient in the list.
<requestOutOfPolicy>	No	complexType	This parameter specifies a list of users who are allowed to submit out-of-policy requests. Out-of-policy requests are subject to approval by a resource mailbox delegate.
<requestOutOfPolicy>/<recipientId>	No	string	This parameter specifies the ID of a recipient in the list.
<resourceDelegates>	No	complexType	This parameter specifies a list of users who are resource mailbox delegates. Resource mailbox delegates can approve or reject requests sent to this resource mailbox.
<resourceDelegates>/<recipientId>	No	string	This parameter specifies the ID of a recipient in the list.
<tentativePendingApproval>	No	boolean	This parameter specifies whether to mark pending requests as tentative on the calendar. If set to False, pending requests are marked as free.
<allowConflicts>	No	boolean	This parameter specifies whether to allow conflicting meeting requests.
<allowRecurringMeetings>	No	boolean	This parameter specifies whether to allow recurring meetings.
<bookingWindowInDays>	No	nonNegativeInteger	This parameter specifies the number of days meetings are allowed to be booked in advance.
<conflictPercentageAllowed>	No	nonNegativeInteger	This parameter specifies a conflict percentage threshold for recurring meetings. If the percentage of instances of a recurring meeting that conflict with other meetings exceeds this number, the recurring meeting request will be declined.
<enforceSchedulingHorizon>	No	boolean	This parameter specifies whether recurring meetings that have an end date beyond the booking window will be rejected.
<maximumConflictInstances>	No	nonNegativeInteger	This parameter specifies the maximum number of conflicts allowed for recurring meetings. If the number of instances for a recurring meeting that are in conflict exceeds this number, the recurring meeting request will be declined.
<maximumDurationInMinutes>	No	nonNegativeInteger	This parameter specifies the maximum duration allowed for incoming meeting requests.
<processExternalMeetingMessages>	No	boolean	This parameter specifies whether to process meeting requests originating outside the Exchange organization.
<scheduleOnlyDuringWorkHours>	No	boolean	This parameter specifies whether to allow meetings to be scheduled outside work hours.
<addNewRequestsTentatively>	No	boolean	This parameter specifies whether to put new calendar items tentatively on the calendar. If the AddNewRequestsTentatively parameter is set to False, only existing calendar items are updated by the Calendar Attendant.
<addOrganizerToSubject>	No	boolean	This parameter specifies whether the meeting organizer's name will be used as the subject of the meeting request.
<defaultReminderTime>	No	nonNegativeInteger	This parameter specifies the default reminder time for the meeting requests.
<deleteAttachments>	No	boolean	This parameter specifies whether to remove the attachments from all incoming requests and messages.
<deleteComments>	No	boolean	This parameter specifies whether to remove any text in the message body of incoming requests.
<deleteNonCalendarItems>	No	boolean	This parameter specifies whether to remove all non-calendar items received by the mailbox.
<deleteSubject>	No	boolean	This parameter specifies whether to remove the subject from all incoming requests and messages.
<disableReminders>	No	boolean	This parameter specifies if you want to disable reminders for meetings in the mailbox.
<organizerInfo>	No	boolean	This parameter specifies whether to send organizer information when a meeting request is declined because of conflicts.
<removeForwardedMeetingNotifications>	No	boolean	This parameter specifies whether to move meeting forwarding notifications to the Deleted Items folder after they are processed by the Calendar Attendant.
<removeOldMeetingMessages>	No	boolean	This parameter specifies whether to remove old and redundant updates and responses.
<removePrivateProperty>	No	boolean	This parameter specifies whether to remove the "private" flag of incoming requests.
<addAdditionalResponse>	No	boolean	This parameter specifies whether additional information would be sent from the resource mailbox when responding to meeting requests.
<additionalResponse>	No	string	This parameter specifies the additional information to be included in responses to meeting requests.
<enableResponseDetails>	No	boolean	This parameter specifies whether to include the reasons for accepting or declining a meeting in the response e-mail message.

Remarks

Schema Definition

Input

<executeData>
		<preferredDomainController>1..1</preferredDomainController>
		<user>1..1</user>
		<alias>0..1</alias>
	<emailAddresses>
		0..1
		<value>1..unbounded</value>
	</emailAddresses>
		<resourceCapacity>0..1</resourceCapacity>
<automateProcessing>0..1</automateProcessing>
		<allBookInPolicy>0..1</allBookInPolicy>
		<allRequestInPolicy>0..1</allRequestInPolicy>
		<allRequestOutOfPolicy>0..1</allRequestOutOfPolicy>
	<bookInPolicy>
		0..1
		<recipientId>0..unbound</recipientId>
	</bookInPolicy>
	<forwardRequestsToDelegates>0..1</forwardRequestsToDelegates>
	<requestInPolicy>
		0..1
		<recipientId>0..unbound</recipientId>
	</requestInPolicy>
	<requestOutOfPolicy>
		0..1
		<recipientId>0..unbound</recipientId>
	</requestOutOfPolicy>
	<resourceDelegates>
		0..1
		<recipientId>0..unbound</recipientId>
	</resourceDelegates>
		<tentativePendingApproval>0..1</tentativePendingApproval>
		<allowConflicts>0..1</allowConflicts>
		<allowRecurringMeetings>0..1</allowRecurringMeetings>
		<bookingWindowInDays>0..1</bookingWindowInDays>
		<conflictPercentageAllowed>0..1</conflictPercentageAllowed>
		<enforceSchedulingHorizon>0..1</enforceSchedulingHorizon>
		<maximumConflictInstances>0..1</maximumConflictInstances>
		<maximumDurationInMinutes>0..1</maximumDurationInMinutes>
		<processExternalMeetingMessages>0..1</processExternalMeetingMessages>
		<scheduleOnlyDuringWorkHours>0..1</scheduleOnlyDuringWorkHours>
		<addNewRequestsTentatively>0..1</addNewRequestsTentatively>
		<addOrganizerToSubject>0..1</addOrganizerToSubject>
		<defaultReminderTime>0..1</defaultReminderTime>
		<deleteAttachments>0..1</deleteAttachments>
		<deleteComments>0..1</deleteComments>
		<deleteNonCalendarItems>0..1</deleteNonCalendarItems>
		<deleteSubject>0..1</deleteSubject>
		<disableReminders>0..1</disableReminders>
		<organizerInfo>0..1</organizerInfo>
		<removeForwardedMeetingNotifications>0..1</removeForwardedMeetingNotifications>
		<removeOldMeetingMessages>0..1</removeOldMeetingMessages>
		<removePrivateProperty>0..1</removePrivateProperty>
		<addAdditionalResponse>0..1</addAdditionalResponse>
		<additionalResponse>0..1</additionalResponse>
		<enableResponseDetails>0..1</enableResponseDetails>
</executeData>

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request>
  <data>
	<!--The domain controller to use for Active Directory actions.-->
	<preferredDomainController>AD01.Fabrikam.Com</preferredDomainController>
	<!--Specifies the LDAP path of the user object for which the mailbox will be created.-->
	<user>LDAP://CN=Room101,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user>
	<!--Specifies the proxy addresses of the mailbox.  The primary Simple Mail Transfer Protocol (SMTP) address is the first in the list of proxy addresses.-->
	<emailAddresses>
	<!--SMTP proxy address.-->
	<value>room101@alpineskihouse.com</value>
	</emailAddresses>
	<!--Capacity of the resource-->
	<resourceCapacity>15</resourceCapacity>
	<!--Specifies the automate calendar processing behaviors on the mailbox.-->
	<automateProcessing>AutoAccept</automateProcessing>
	<!--Specifies whether to automatically approve in-policy requests from all users.-->
	<allBookInPolicy>true</allBookInPolicy>
	<!--Specifies whether to allow all users to submit in-policy requests.-->
	<allRequestInPolicy>true</allRequestInPolicy>
	<!--Specifies whether to allow all users to submit out-of-policy requests.-->
	<allRequestOutOfPolicy>true</allRequestOutOfPolicy>
	<!--Specifies a list of users who are allowed to submit in-policy meeting requests to the resource mailbox.-->
	<bookInPolicy>
	<!--Specifies the ID of a recipient in the list.-->
	<recipientId>johnc@alpineskihouse.com</recipientId>
	</bookInPolicy>
	<!--Specifies whether to forward incoming meeting requests to the delegates defined for the mailbox.-->
	<forwardRequestsToDelegates>true</forwardRequestsToDelegates>
	<!--Specifies a list of users who are allowed to submit in-policy meeting requests to the resource mailbox.-->
	<requestInPolicy>
	<!--Specifies the ID of a recipient in the list.-->
	<recipientId>johnc@alpineskihouse.com</recipientId>
	</requestInPolicy>
	<!--Specifies a list of users who are allowed to submit out-of-policy requests.-->
	<requestOutOfPolicy>
	<!--Specifies the ID of a recipient in the list.-->
	<recipientId>johnc@alpineskihouse.com</recipientId>
	</requestOutOfPolicy>
	<!--Specifies a list of users who are resource mailbox delegates. Resource mailbox delegates can approve or reject requests sent to this resource mailbox.-->
	<resourceDelegates>
	<!--Specifies the ID of a recipient in the list.-->
	<recipientId>johnc@alpineskihouse.com</recipientId>
	</resourceDelegates>
	<!--Specifies whether to mark pending requests as tentative on the calendar. If set to False, pending requests are marked as free.-->
	<tentativePendingApproval>true</tentativePendingApproval>
	<!--Specifies whether to allow conflicting meeting requests.-->
	<allowConflicts>true</allowConflicts>
	<!--Specifies whether to allow recurring meetings.-->
	<allowRecurringMeetings>true</allowRecurringMeetings>
	<!--Specifies the number of days meetings are allowed to be booked in advance.-->
	<bookingWindowInDays>180</bookingWindowInDays>
	<!--Specifies a conflict percentage threshold for recurring meetings.-->
	<conflictPercentageAllowed>0</conflictPercentageAllowed>
	<!--Specifies whether recurring meetings that have an end date beyond the booking window will be rejected.-->
	<enforceSchedulingHorizon>true</enforceSchedulingHorizon>
	<!--Specifies the maximum number of conflicts allowed for recurring meetings. -->
	<maximumConflictInstances>0</maximumConflictInstances>
	<!--Specifies the maximum duration allowed for incoming meeting requests.-->
	<maximumDurationInMinutes>1440</maximumDurationInMinutes>
	<!--Specifies whether to process meeting requests originating outside the Exchange organization.-->
	<processExternalMeetingMessages>true</processExternalMeetingMessages>
	<!--Specifies whether to allow meetings to be scheduled outside work hours.-->
	<scheduleOnlyDuringWorkHours>true</scheduleOnlyDuringWorkHours>
	<!--Specifies whether to put new calendar items tentatively on the calendar. -->
	<addNewRequestsTentatively>true</addNewRequestsTentatively>
	<!--Specifies whether the meeting organizer's name will be used as the subject of the meeting request.-->
	<addOrganizerToSubject>true</addOrganizerToSubject>
	<!--Specifies the default reminder time for the meeting requests.-->
	<defaultReminderTime>5</defaultReminderTime>
	<!--Specifies whether to remove the attachments from all incoming requests and messages.-->
	<deleteAttachments>true</deleteAttachments>
	<!--Specifies whether to remove any text in the message body of incoming requests.-->
	<deleteComments>true</deleteComments>
	<!--Specifies whether to remove all non-calendar items received by the mailbox.-->
	<deleteNonCalendarItems>true</deleteNonCalendarItems>
	<!--Specifies whether to remove the subject from all incoming requests and messages.-->
	<deleteSubject>true</deleteSubject>
	<!--Specifies if you want to disable reminders for meetings in the mailbox.-->
	<disableReminders>true</disableReminders>
	<!--Specifies whether to send organizer information when a meeting request is declined because of conflicts.-->
	<organizerInfo>true</organizerInfo>
	<!--Specifies whether to move meeting forwarding notifications to the Deleted Items folder after they are processed by the Calendar Attendant.-->
	<removeForwardedMeetingNotifications>true</removeForwardedMeetingNotifications>
	<!--Specifies whether to remove old and redundant updates and responses.-->
	<removeOldMeetingMessages>true</removeOldMeetingMessages>
	<!--Specifies whether to remove the "private" flag of incoming requests.-->
	<removePrivateProperty>true</removePrivateProperty>
	<!--Specifies whether additional information would be sent from the resource mailbox when responding to meeting requests.-->
	<addAdditionalResponse>true</addAdditionalResponse>
	<!--Specifies the additional information to be included in responses to meeting requests.-->
	<additionalResponse>Room location: Southwest in the second floor of the AlpineSki building.</additionalResponse>
	<!--Specifies whether to include the reasons for accepting or declining a meeting in the response e-mail message.-->
	<enableResponseDetails>true</enableResponseDetails>
  </data>
  <procedure>
	<execute namespace="Hosted Email 2007" procedure="ModifyResourceMailbox" impersonate="1">
	<before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" />
	<before source="data" sourcePath="user" destination="executeData" mode="move" />
	<before source="data" sourcePath="emailAddresses" destination="executeData" mode="move" />
	<before source="data" sourcePath="resourceCapacity" destination="executeData" mode="move" />
	<before source="data" sourcePath="automateProcessing" destination="executeData" mode="move" />
	<before source="data" sourcePath="allBookInPolicy" destination="executeData" mode="move" />
	<before source="data" sourcePath="allRequestInPolicy" destination="executeData" mode="move" />
	<before source="data" sourcePath="allRequestOutOfPolicy" destination="executeData" mode="move" />
	<before source="data" sourcePath="bookInPolicy" destination="executeData" mode="move" />
	<before source="data" sourcePath="forwardRequestsToDelegates" destination="executeData" mode="move" />
	<before source="data" sourcePath="requestInPolicy" destination="executeData" mode="move" />
	<before source="data" sourcePath="requestOutOfPolicy" destination="executeData" mode="move" />
	<before source="data" sourcePath="resourceDelegates" destination="executeData" mode="move" />
	<before source="data" sourcePath="tentativePendingApproval" destination="executeData" mode="move" />
	<before source="data" sourcePath="allowConflicts" destination="executeData" mode="move" />
	<before source="data" sourcePath="allowRecurringMeetings" destination="executeData" mode="move" />
	<before source="data" sourcePath="bookingWindowInDays" destination="executeData" mode="move" />
	<before source="data" sourcePath="conflictPercentageAllowed" destination="executeData" mode="move" />
	<before source="data" sourcePath="enforceSchedulingHorizon" destination="executeData" mode="move" />
	<before source="data" sourcePath="maximumConflictInstances" destination="executeData" mode="move" />
	<before source="data" sourcePath="maximumDurationInMinutes" destination="executeData" mode="move" />
	<before source="data" sourcePath="processExternalMeetingMessages" destination="executeData" mode="move" />
	<before source="data" sourcePath="scheduleOnlyDuringWorkHours" destination="executeData" mode="move" />
	<before source="data" sourcePath="addNewRequestsTentatively" destination="executeData" mode="move" />
	<before source="data" sourcePath="addOrganizerToSubject" destination="executeData" mode="move" />
	<before source="data" sourcePath="defaultReminderTime" destination="executeData" mode="move" />
	<before source="data" sourcePath="deleteAttachments" destination="executeData" mode="move" />
	<before source="data" sourcePath="deleteComments" destination="executeData" mode="move" />
	<before source="data" sourcePath="deleteNonCalendarItems" destination="executeData" mode="move" />
	<before source="data" sourcePath="deleteSubject" destination="executeData" mode="move" />
	<before source="data" sourcePath="disableReminders" destination="executeData" mode="move" />
	<before source="data" sourcePath="organizerInfo" destination="executeData" mode="move" />
	<before source="data" sourcePath="removeForwardedMeetingNotifications" destination="executeData" mode="move" />
	<before source="data" sourcePath="removeOldMeetingMessages" destination="executeData" mode="move" />
	<before source="data" sourcePath="removePrivateProperty" destination="executeData" mode="move" />
	<before source="data" sourcePath="addAdditionalResponse" destination="executeData" mode="move" />
	<before source="data" sourcePath="additionalResponse" destination="executeData" mode="move" />
	<before source="data" sourcePath="enableResponseDetails" destination="executeData" mode="move" />
	<after source="executeData" destination="data" mode="merge" />
	</execute>
  </procedure>
</request>

Example XML Response

<response>
	<data />
</response>

Applies To