Set-CalendarProcessing
Applies to: Exchange Server 2010
Topic Last Modified: 2011-03-19
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.
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>]]
| 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:
|
|
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 This parameter is ignored unless the AutomateProcessing parameter is set to |
|
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 Valid input for this parameter is |
|
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 This parameter is ignored unless the AutomateProcessing parameter is set to |
|
AllBookInPolicy |
Optional |
System.Boolean |
The AllBookInPolicy parameter specifies whether to automatically approve in-policy requests from all users. Valid input for this parameter is |
|
AllowConflicts |
Optional |
System.Boolean |
The AllowConflicts parameter specifies whether to allow conflicting meeting requests. Valid input for this parameter is |
|
AllowRecurringMeetings |
Optional |
System.Boolean |
The AllowRecurringMeetings parameter specifies whether to allow recurring meetings. Valid input for this parameter is |
|
AllRequestInPolicy |
Optional |
System.Boolean |
The AllRequestInPolicy parameter specifies whether to allow all users to submit in-policy requests. Valid input for this parameter is These requests are subject to approval by a resource mailbox delegate unless the AllBookInPolicy parameter is set to |
|
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 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:
The default setting is |
|
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:
|
|
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 ConflictPercentAllowed 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 This parameter is ignored unless the AutomateProcessing parameter is set to |
|
DeleteComments |
Optional |
System.Boolean |
The DeleteComments parameter removes any text in the message body of incoming meeting requests. Valid input for this parameter is This parameter is ignored unless the AutomateProcessing parameter is set to |
|
DeleteNonCalendarItems |
Optional |
System.Boolean |
The DeleteNonCalendarItems parameter is set to |
|
DeleteSubject |
Optional |
System.Boolean |
The DeleteSubject parameter removes the subject of incoming meeting requests. Valid input for this parameter is This parameter is ignored unless the AutomateProcessing parameter is set to |
|
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 is set to |
|
EnforceSchedulingHorizon |
Optional |
System.Boolean |
The EnforceSchedulingHorizon parameter enforces an end date for recurring meetings based on the value of the BookingWindowInDays parameter. Valid input for this parameter is When BookingWindowInDays is 0, an end date isn't enforced for any recurring meetings. When BookingWindowInDays is greater than 0 and EnforceSchedulingHorizon is When BookingWindowInDays is greater than 0 and EnforceSchedulingHorizon is |
|
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 |
|
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:
|
|
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 If a new recurring meeting request conflicts with existing reservations for the resource more than the number of times specified by the MaximumConflictInstances 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 MaximumDurationInMinutes applies to the length of an individual meeting instance. |
|
OrganizerInfo |
Optional |
System.Boolean |
The OrganizerInfo parameter is set to Valid input for this parameter is |
|
ProcessExternalMeetingMessages |
Optional |
System.Boolean |
The ProcessExternalMeetingMessages parameter specifies whether to process meeting requests that originate outside the Exchange organization. If set to |
|
RemoveForwardedMeetingNotifications |
Optional |
System.Boolean |
The RemoveForwardedMeetingNotifications parameter specifies whether meeting forwarding notifications are moved to the Deleted Items folder after they are processed by the Calendar Attendant. Valid input for this parameter is |
|
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 |
|
RemovePrivateProperty |
Optional |
System.Boolean |
The RemovePrivateProperty parameter is set to |
|
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:
|
|
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:
|
|
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:
|
|
ScheduleOnlyDuringWorkHours |
Optional |
System.Boolean |
The ScheduleOnlyDuringWorkHours parameter specifies whether to allow meetings to be scheduled outside work hours. If set to |
|
TentativePendingApproval |
Optional |
System.Boolean |
The TentativePendingApproval parameter specifies whether to mark pending requests as tentative on the calendar. If set to |
|
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. |
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 Mailbox Permissions topic.
| Error | Description |
|---|---|
|
|
|
This example automates the processing of calendar requests to the resource mailbox Conf 212.
Set-CalendarProcessing -Identity "Conf 212" -AutomateProcessing AutoAccept -DeleteComments $true -AddOrganizerToSubject $true -AllowConflicts $false
This example disables automatic processing for the resource mailbox Car 54.
Set-CalendarProcessing -Identity "CAR54" -AutomateProcessing:None
This example disables the automatic creation of new calendar items but maintains updates for existing calendar items of David Pelton's mailbox.
Set-CalendarProcessing -Identity "David Pelton" -AddNewRequestsTentatively:$false
This example allows the Calendar Attendant to approve in-policy requests from all users.
Set-CalendarProcessing -Identity "5th Floor Conference Room" -AutomateProcessing AutoAccept -AllBookInPolicy $true
This example allows all users to submit in-policy requests, but the request is still subject to approval by a delegate.
Set-CalendarProcessing -Identity "5th Floor Conference Room" -AutomateProcessing AutoAccept -AllRequestInPolicy $true
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.
Set-CalendarProcessing -Identity "Room222" -AutomateProcessing AutoAccept -RequestOutOfPolicy DavidPelton@contoso.com
This example allows a list of users to submit in-policy meeting requests to the equipment mailbox for Car 54.
Set-CalendarProcessing -Identity "Car 54" -AutomateProcessing AutoAccept -BookInPolicy "ayla@contoso.com","tony@contoso.com"
This example rejects meeting requests from any user who isn't a member of the Exchange organization.
Set-CalendarProcessing -Identity "Room222" -ProcessExternalMeetingMessages $false
