Applies to: Exchange Server 2013, Exchange Online

Topic Last Modified: 2012-09-12

Use the Set-CalendarProcessing cmdlet to modify calendar-related processing configuration properties for the target mailbox, which include Calendar Attendant, resource booking assistant, and calendar configuration.

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax


Set-CalendarProcessing -Identity <MailboxIdParameter> [-AddAdditionalResponse <$true \| $false>] [-AdditionalResponse <String>] [-AddNewRequestsTentatively <$true \| $false>] [-AddOrganizerToSubject <$true \| $false>] [-AllBookInPolicy <$true \| $false>] [-AllowConflicts <$true \| $false>] [-AllowRecurringMeetings <$true \| $false>] [-AllRequestInPolicy <$true \| $false>] [-AllRequestOutOfPolicy <$true \| $false>] [-AutomateProcessing <None \| AutoUpdate \| AutoAccept>] [-BookingWindowInDays <Int32>] [-BookInPolicy <RecipientIdParameter[]>] [-Confirm [<SwitchParameter>]] [-ConflictPercentageAllowed <Int32>] [-DeleteAttachments <$true \| $false>] [-DeleteComments <$true \| $false>] [-DeleteNonCalendarItems <$true \| $false>] [-DeleteSubject <$true \| $false>] [-DomainController <Fqdn>] [-EnableResponseDetails <$true \| $false>] [-EnforceSchedulingHorizon <$true \| $false>] [-ForwardRequestsToDelegates <$true \| $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MaximumConflictInstances <Int32>] [-MaximumDurationInMinutes <Int32>] [-OrganizerInfo <$true \| $false>] [-ProcessExternalMeetingMessages <$true \| $false>] [-RemoveForwardedMeetingNotifications <$true \| $false>] [-RemoveOldMeetingMessages <$true \| $false>] [-RemovePrivateProperty <$true \| $false>] [-RequestInPolicy <RecipientIdParameter[]>] [-RequestOutOfPolicy <RecipientIdParameter[]>] [-ResourceDelegates <RecipientIdParameter[]>] [-ScheduleOnlyDuringWorkHours <$true \| $false>] [-TentativePendingApproval <$true \| $false>] [-WhatIf [<SwitchParameter>]]

Set-CalendarProcessing -Identity
<MailboxIdParameter> [-AddAdditionalResponse <$true |
$false>] [-AdditionalResponse <String>]
[-AddNewRequestsTentatively <$true | $false>]
[-AddOrganizerToSubject <$true | $false>] [-AllBookInPolicy
<$true | $false>] [-AllowConflicts <$true | $false>]
[-AllowRecurringMeetings <$true | $false>]
[-AllRequestInPolicy <$true | $false>]
[-AllRequestOutOfPolicy <$true | $false>]
[-AutomateProcessing <None | AutoUpdate | AutoAccept>]
[-BookingWindowInDays <Int32>] [-BookInPolicy
<RecipientIdParameter[]>] [-Confirm
[<SwitchParameter>]] [-ConflictPercentageAllowed
<Int32>] [-DeleteAttachments <$true | $false>]
[-DeleteComments <$true | $false>] [-DeleteNonCalendarItems
<$true | $false>] [-DeleteSubject <$true | $false>]
[-DomainController <Fqdn>] [-EnableResponseDetails <$true
| $false>] [-EnforceSchedulingHorizon <$true | $false>]
[-ForwardRequestsToDelegates <$true | $false>]
[-IgnoreDefaultScope <SwitchParameter>]
[-MaximumConflictInstances <Int32>]
[-MaximumDurationInMinutes <Int32>] [-OrganizerInfo <$true
| $false>] [-ProcessExternalMeetingMessages <$true |
$false>] [-RemoveForwardedMeetingNotifications <$true |
$false>] [-RemoveOldMeetingMessages <$true | $false>]
[-RemovePrivateProperty <$true | $false>] [-RequestInPolicy
<RecipientIdParameter[]>] [-RequestOutOfPolicy
<RecipientIdParameter[]>] [-ResourceDelegates
<RecipientIdParameter[]>] [-ScheduleOnlyDuringWorkHours
<$true | $false>] [-TentativePendingApproval <$true |
$false>] [-WhatIf [<SwitchParameter>]]

Examples

EXAMPLE 1

This example automates the processing of calendar requests to the resource mailbox Conf 212.

	Copy Code
Set-CalendarProcessing -Identity "Conf 212" -AutomateProcessing AutoAccept -DeleteComments $true -AddOrganizerToSubject $true -AllowConflicts $false

EXAMPLE 2

This example disables automatic processing for the resource mailbox Car 54.

	Copy Code
Set-CalendarProcessing -Identity "CAR54" -AutomateProcessing:None

EXAMPLE 3

This example disables the automatic creation of new calendar items but maintains updates for existing calendar items of David Pelton's mailbox.

	Copy Code
Set-CalendarProcessing -Identity "David Pelton" -AddNewRequestsTentatively:$false

EXAMPLE 4

This example allows the Calendar Attendant to approve in-policy requests from all users.

	Copy Code
Set-CalendarProcessing -Identity "5th Floor Conference Room" -AutomateProcessing AutoAccept -AllBookInPolicy $true

EXAMPLE 5

This example allows all users to submit in-policy requests, but the request is still subject to approval by a delegate.

	Copy Code
Set-CalendarProcessing -Identity "5th Floor Conference Room" -AutomateProcessing AutoAccept -AllRequestInPolicy $true

EXAMPLE 6

This example allows the Calendar Attendant to accept out-of-policy requests from David Pelton. The request is still subject to approval by a delegate.

	Copy Code
Set-CalendarProcessing -Identity "Room222" -AutomateProcessing AutoAccept -RequestOutOfPolicy DavidPelton@contoso.com

EXAMPLE 7

This example allows a list of users to submit in-policy meeting requests to the equipment mailbox for Car 54.

	Copy Code
Set-CalendarProcessing -Identity "Car 54" -AutomateProcessing AutoAccept -BookInPolicy "ayla@contoso.com","tony@contoso.com"

EXAMPLE 8

This example rejects meeting requests from any user who isn't a member of the Exchange organization.

	Copy Code
Set-CalendarProcessing -Identity "Room222" -ProcessExternalMeetingMessages $false

Detailed Description

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Calendar processing" entry in the Recipients Permissions topic.

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter	The Identity parameter specifies the identity of the mailbox. This parameter can take any of the following values: Distinguished name (DN) Canonical name GUID Name Display name Alias Exchange DN Primary SMTP email address
AddAdditionalResponse	Optional	System.Boolean	The AddAdditionalResponse parameter specifies whether additional information would be sent from the resource mailbox when responding to meeting requests. Valid input for this parameter is `$true` or `$false`. This parameter is ignored unless the AutomateProcessing parameter is set to `AutoAccept`.
AdditionalResponse	Optional	System.String	The AdditionalResponse parameter specifies the additional information to be included in responses to meeting requests.
AddNewRequestsTentatively	Optional	System.Boolean	The AddNewRequestsTentatively parameter specifies whether to have the Calendar Attendant 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. Valid input for this parameter is `$true` or `$false`.
AddOrganizerToSubject	Optional	System.Boolean	The AddOrganizerToSubject parameter specifies whether the meeting organizer's name is used as the subject of the meeting request. Valid input for this parameter is `$true` or `$false`. This parameter is ignored unless the AutomateProcessing parameter is set to `AutoAccept`.
AllBookInPolicy	Optional	System.Boolean	The AllBookInPolicy parameter specifies whether to automatically approve in-policy requests from all users. Valid input for this parameter is `$true` or `$false`.
AllowConflicts	Optional	System.Boolean	The AllowConflicts parameter specifies whether to allow conflicting meeting requests. Valid input for this parameter is `$true` or `$false`.
AllowRecurringMeetings	Optional	System.Boolean	The AllowRecurringMeetings parameter specifies whether to allow recurring meetings. Valid input for this parameter is `$true` or `$false`.
AllRequestInPolicy	Optional	System.Boolean	The AllRequestInPolicy parameter specifies whether to allow all users to submit in-policy requests. Valid input for this parameter is `$true` or `$false`. These requests are subject to approval by a resource mailbox delegate unless the AllBookInPolicy parameter is set to `$true`.
AllRequestOutOfPolicy	Optional	System.Boolean	The AllRequestOutOfPolicy parameter specifies whether to allow all users to submit out-of-policy requests. Valid input for this parameter is `$true` or `$false`. Out-of-policy requests are subject to approval by a resource mailbox delegate.
AutomateProcessing	Optional	Microsoft.Exchange.Data.Storage.CalendarProcessingFlags	The AutomateProcessing parameter enables or disables calendar processing on the mailbox. This parameter takes the following values: `None` If this parameter is set to `None`, both the resource booking attendant and the Calendar Attendant are disabled on the mailbox. `AutoUpdate` If this parameter is set to `AutoUpdate`, only the Calendar Attendant processes meeting requests and responses. We recommend this setting. `AutoAccept` If this parameter is set to `AutoAccept`, both the Calendar Attendant and resource booking attendant are enabled on the mailbox. This means that the Calendar Attendant updates the calendar, and then the resource booking assistant accepts the meeting based upon the policies. The default setting is `AutoUpdate`.
BookingWindowInDays	Optional	System.Int32	The BookingWindowInDays parameter specifies the maximum number of days in advance that the resource can be reserved. Valid input is an integer from 0 through 1080. When the value is set to 0, the resource can be reserved at any date in the future.
BookInPolicy	Optional	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	The BookInPolicy 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 are automatically approved. This parameter can take any of the following values: DN Canonical name GUID Name Display name Alias Exchange DN Primary SMTP email address
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.
ConflictPercentageAllowed	Optional	System.Int32	The ConflictPercentageAllowed parameter specifies the maximum percentage of meeting conflicts for new recurring meeting requests. Valid input for this parameter is an integer from 0 through 100. If a new recurring meeting request conflicts with existing reservations for the resource more than the percentage specified by the ConflictPercentageAllowed value, the recurring meeting request is automatically declined. When the value is 0, no conflicts are permitted for new recurring meeting requests.
DeleteAttachments	Optional	System.Boolean	The DeleteAttachments parameter specifies whether to remove attachments from all incoming messages. Valid input for this parameter is `$true` or `$false`. This parameter is ignored unless the AutomateProcessing parameter is set to `AutoAccept`.
DeleteComments	Optional	System.Boolean	The DeleteComments parameter removes any text in the message body of incoming meeting requests. Valid input for this parameter is `$true` or `$false`. This parameter is ignored unless the AutomateProcessing parameter is set to `AutoAccept`.
DeleteNonCalendarItems	Optional	System.Boolean	The DeleteNonCalendarItems parameter is set to `$true` to remove all non-calendar items received by the mailbox. Valid input for this parameter is `$true` or `$false`.
DeleteSubject	Optional	System.Boolean	The DeleteSubject parameter removes the subject of incoming meeting requests. Valid input for this parameter is `$true` or `$false`. This parameter is ignored unless the AutomateProcessing parameter is set to `AutoAccept`.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.
EnableResponseDetails	Optional	System.Boolean	The EnableResponseDetails parameter specifies whether to include the reasons for accepting or declining a meeting in the response email message. When the EnableResponseDetails parameter is set to `$true`, the reasons for accepting or declining a meeting in the response email message are included. Valid input for this parameter is `$true` or `$false`.
EnforceSchedulingHorizon	Optional	System.Boolean	The EnforceSchedulingHorizon parameter specifies whether to enforce an end date for recurring meetings based on the value of the BookingWindowInDays parameter. Valid input for this parameter is `$true` or `$false`. When the BookingWindowInDays parameter value is 0, an end date isn't enforced for any recurring meetings. When the BookingWindowInDays parameter value is greater than 0 and the EnforceSchedulingHorizon parameter value is `$true`, the recurring meeting request is automatically declined if the end date is greater than the value specified by the BookingWindowInDays parameter. When the BookingWindowInDays parameter value is greater than 0 and the EnforceSchedulingHorizon parameter value is `$false`, the end date of a recurring meeting is automatically truncated to the value specified by the BookingWindowInDays parameter.
ForwardRequestsToDelegates	Optional	System.Boolean	The ForwardRequestsToDelegates parameter specifies whether to forward incoming meeting requests to the delegates defined for the mailbox. Valid input for this parameter is `$true` or `$false`.
IgnoreDefaultScope	Optional	System.Management.Automation.SwitchParameter	The IgnoreDefaultScope parameter instructs the command to ignore the default recipient scope setting for the Exchange Management Shell session and use the entire forest as the scope. This allows the command to access Active Directory objects that aren't currently in the default scope. Using the IgnoreDefaultScope parameter introduces the following restrictions: You can't use the DomainController parameter. The command uses an appropriate global catalog server automatically. You can only use the DN for the Identity parameter. Other forms of identification, such as alias or GUID, aren't accepted.
MaximumConflictInstances	Optional	System.Int32	The MaximumConflictInstances parameter specifies the maximum number of conflicts for new recurring meeting requests when the AllowRecurringMeetings parameter is set to `$true`. Valid input for this parameter is an integer from 0 through 2147483647. If a new recurring meeting request conflicts with existing reservations for the resource more than the number of times specified by the MaximumConflictInstances parameter value, the recurring meeting request is automatically declined. When the value is 0, no conflicts are permitted for new recurring meeting requests.
MaximumDurationInMinutes	Optional	System.Int32	The MaximumDurationInMinutes parameter specifies the maximum duration allowed for incoming meeting requests. Valid input for this parameter is an integer from 0 through 2147483647. When the value is set to 0, the maximum duration of a meeting is unlimited. For recurring meetings, the value of the MaximumDurationInMinutes parameter applies to the length of an individual meeting instance.
OrganizerInfo	Optional	System.Boolean	The OrganizerInfo parameter specifies whether to have resource mailboxes send organizer information when a meeting request is declined because of conflicts. When the OrganizerInfo parameter is set to `$true`, resource mailboxes send organizer information when a meeting request is declined because of conflicts. Valid input for this parameter is `$true` or `$false`.
ProcessExternalMeetingMessages	Optional	System.Boolean	The ProcessExternalMeetingMessages parameter specifies whether to process meeting requests that originate outside the Exchange organization. If set to `$false`, meeting requests that originate outside of the organization are rejected. Valid input for this parameter is `$true` or `$false`.
RemoveForwardedMeetingNotifications	Optional	System.Boolean	The RemoveForwardedMeetingNotifications parameter specifies whether forwarded meeting notifications are moved to the Deleted Items folder after they're processed by the Calendar Attendant. Valid input for this parameter is `$true` or `$false`.
RemoveOldMeetingMessages	Optional	System.Boolean	The RemoveOldMeetingMessages parameter specifies whether the Calendar Attendant removes old and redundant updates and responses. Valid input for this parameter is `$true` or `$false`.
RemovePrivateProperty	Optional	System.Boolean	The RemovePrivateProperty parameter specifies whether to clear the private flag for incoming meeting requests. When the RemovePrivateProperty parameter is set to `$true`, the private flag for incoming meeting requests is cleared. To ensure the private flag that was sent by the organizer in the original request remains as specified, set the RemovePrivateProperty parameter to `$false` for the room mailbox. Valid input for this parameter is `$true` or `$false`.
RequestInPolicy	Optional	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	The RequestInPolicy 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 are subject to approval by a resource mailbox delegate. This parameter can take the following values: DN Canonical name GUID Name Display name Alias Exchange DN Primary SMTP email address
RequestOutOfPolicy	Optional	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	The RequestOutOfPolicy 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. This parameter can take the following values: DN Canonical name GUID Name Display name Alias Exchange DN Primary SMTP email address
ResourceDelegates	Optional	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	The ResourceDelegates parameter specifies a list of users who are resource mailbox delegates. Resource mailbox delegates can approve or reject requests sent to this resource mailbox. This parameter can take the following values: DN Canonical name GUID Name Display name Alias Exchange DN Primary SMTP email address
ScheduleOnlyDuringWorkHours	Optional	System.Boolean	The ScheduleOnlyDuringWorkHours parameter specifies whether to allow meetings to be scheduled outside work hours. If set to `$true`, meeting requests for times outside of the mailbox's working hours will be rejected. Valid input for this parameter is `$true` or `$false`.
TentativePendingApproval	Optional	System.Boolean	The TentativePendingApproval parameter specifies whether to mark pending requests as tentative on the calendar. If set to `$false`, pending requests are marked as free. Valid input for this parameter is `$true` or `$false`.
WhatIf	Optional	System.Management.Automation.SwitchParameter	The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.