Hosted Email 2007::ModifyResourceMailbox

  • Article

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

Arguments

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

Security

Caller must be at least a member of role: UserCreators.

Permission Check

No explicit permission check is required for this procedure. The procedure calls Managed Email 2007::ModifyResourceMailbox which performs a test for UserCreators.

Preconditions

The Hosted Email 2007 namespace has been initialized.

Post-conditions

The specified attributes are set to the resource mailbox.

Note

Modification of some basic mailbox attributes is not supported in this procedure to avoid redundancy. User can call the Hosted Email 2007::ModifyMailbox procedure to modify them.

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

Hosted Email 2007 Namespace for:

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

Hosted Email 2007::CreateResourceMailbox
Hosted Email 2007::DeleteResouceMailbox
Hosted Email 2007::GetResourceMailbox