Set-MailboxCalendarSettings (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
Use the Set-MailboxCalendarSettings cmdlet to enable calendar processing for a mailbox.
Syntax
Set-MailboxCalendarSettings -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[]>] [-ConflictPercentageAllowed <Int32>] [-DefaultReminderTime <Int32>] [-DeleteAttachments <$true | $false>] [-DeleteComments <$true | $false>] [-DeleteNonCalendarItems <$true | $false>] [-DeleteSubject <$true | $false>] [-DisableReminders <$true | $false>] [-DomainController <Fqdn>] [-EnableResponseDetails <$true | $false>] [-EnforceSchedulingHorizon <$true | $false>] [-ForwardRequestsToDelegates <$true | $false>] [-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>]
Set-MailboxCalendarSettings [-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[]>] [-ConflictPercentageAllowed <Int32>] [-DefaultReminderTime <Int32>] [-DeleteAttachments <$true | $false>] [-DeleteComments <$true | $false>] [-DeleteNonCalendarItems <$true | $false>] [-DeleteSubject <$true | $false>] [-DisableReminders <$true | $false>] [-DomainController <Fqdn>] [-EnableResponseDetails <$true | $false>] [-EnforceSchedulingHorizon <$true | $false>] [-ForwardRequestsToDelegates <$true | $false>] [-Instance <ADUser>] [-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>]
Detailed Description
The Set-MailboxCalendarSettings cmdlet lets you enable calendar processing for a mailbox. You can configure parameters for automatic resource booking or Calendar Attendant processing.
To run the Set-MailboxCalendarSettings cmdlet, the account you use must be delegated the following:
- Exchange Organization Administrator role
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
The Identity parameter specifies the identity of the mailbox. |
AddAdditionalResponse |
Optional |
System.Boolean |
The AddAdditionalResponse parameter specifies whether additional information would be sent from the resource mailbox when responding to meeting requests. This parameter is ignored unless the AutomateProcessing parameter is set to AutoAccept. |
AdditionalResponse |
Optional |
System.String |
Use the AdditionalResponse parameter to specify the additional information to be included in responses to meeting requests. |
AddNewRequestsTentatively |
Optional |
System.Boolean |
Set the AddNewRequestsTentatively parameter to $true 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. |
AddOrganizerToSubject |
Optional |
System.Boolean |
Use the AddOrganizerToSubject parameter to specify whether the meeting organizer's name will be used as the subject of the meeting request. This parameter is ignored unless the AutomateProcessing parameter is set to AutoAccept. |
AllBookInPolicy |
Optional |
System.Boolean |
Use the AllBookInPolicy parameter to specify whether to automatically approve in-policy requests from all users. |
AllowConflicts |
Optional |
System.Boolean |
Use the AllowConflicts parameter to specify whether to allow conflicting meeting requests. |
AllowRecurringMeetings |
Optional |
System.Boolean |
Use the AllowRecurringMeetings parameter to specify whether to allow recurring meetings. |
AllRequestInPolicy |
Optional |
System.Boolean |
Use the AllRequestInPolicy parameter to specify whether to allow all users to submit in-policy requests. These requests will be subject to approval by a resource mailbox delegate unless the AllBookInPolicy parameter is set to $true. |
AllRequestOutOfPolicy |
Optional |
System.Boolean |
Use the AllRequestOutOfPolicy parameter to specify whether to allow all users to submit out-of-policy requests. Out-of-policy requests are subject to approval by a resource mailbox delegate. |
AutomateProcessing |
Optional |
Microsoft.Exchange.Data.Storage.CalendarProcessingFlags |
Use the AutomateProcessing parameter to enable or disable calendar processing on the mailbox. If this parameter is set to None, both resource booking and the Calendar Attendant will be disabled on the mailbox. If set to AutoUpdate, the Calendar Attendant will process meeting requests and responses. If this parameter is set to AutoAccept, resource booking will be enabled on the mailbox. |
BookingWindowInDays |
Optional |
System.Int32 |
Use the BookingWindowInDays parameter to specify the number of days meetings are allowed to be booked in advance. |
BookInPolicy |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Use the BookInPolicy parameter to specify 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. |
ConflictPercentageAllowed |
Optional |
System.Int32 |
Use the ConflictPercentageAllowed parameter to set 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. |
DefaultReminderTime |
Optional |
System.Int32 |
Use the DefaultReminderTime parameter to specify the default reminder time for the meeting requests. |
DeleteAttachments |
Optional |
System.Boolean |
Set the DeleteAttachments parameter to $true to remove attachments from all incoming messages. This parameter is ignored unless the AutomateProcessing parameter is set to AutoAccept. |
DeleteComments |
Optional |
System.Boolean |
Use the DeleteComments parameter to remove any text in the message body of incoming meeting requests. This parameter is ignored unless the AutomateProcessing parameter is set to AutoAccept. |
DeleteNonCalendarItems |
Optional |
System.Boolean |
Set the DeleteNonCalendarItems parameter to $true to remove all non-calendar items received by the mailbox. |
DeleteSubject |
Optional |
System.Boolean |
Use the DeleteSubject parameter to remove the subject of incoming meeting requests. This parameter is ignored unless the AutomateProcessing parameter is set to AutoAccept. |
DisableReminders |
Optional |
System.Boolean |
Use the DisableReminders parameter to specify if you want to disable reminders for meetings in the mailbox. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command. |
EnableResponseDetails |
Optional |
System.Boolean |
Set the EnableResponseDetails parameter to $true to include the reasons for accepting or declining a meeting in the response e-mail message. |
EnforceSchedulingHorizon |
Optional |
System.Boolean |
Use the EnforceSchedulingHorizon parameter to specify whether recurring meetings that have an end date beyond the booking window will be rejected. |
ForwardRequestsToDelegates |
Optional |
System.Boolean |
Use the ForwardRequestsToDelegates parameter to specify whether to forward incoming meeting requests to the delegates defined for the mailbox. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Recipient.ADUser |
The Instance parameter enables you to pass an entire object to the command to be processed. It is mainly used in scripts where an entire object must be passed to the command. |
MaximumConflictInstances |
Optional |
System.Int32 |
Use the MaximumConflictInstances parameter to set 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 |
Optional |
System.Int32 |
Use the MaximumDurationInMinutes parameter to specify the maximum duration allowed for incoming meeting requests. |
OrganizerInfo |
Optional |
System.Boolean |
Set the OrganizerInfo parameter to $true to have resource mailboxes send organizer information when a meeting request is declined because of conflicts. |
ProcessExternalMeetingMessages |
Optional |
System.Boolean |
Use the ProcessExternalMeetingMessages parameter to specify whether to process meeting requests originating outside the Exchange organization. |
RemoveForwardedMeetingNotifications |
Optional |
System.Boolean |
If the RemoveForwardedMeetingNotifications parameter is set to $true, meeting forwarding notifications are moved to the Deleted Items folder after they are processed by the Calendar Attendant. |
RemoveOldMeetingMessages |
Optional |
System.Boolean |
If the RemoveOldMeetingMessages parameter is set to $true, the Calendar Attendant removes old and redundant updates and responses. |
RemovePrivateProperty |
Optional |
System.Boolean |
Set the RemovePrivateProperty parameter to $true to clear the private flag for incoming meeting requests. |
RequestInPolicy |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Use the RequestInPolicy parameter to specify 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. |
RequestOutOfPolicy |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Use the RequestOutOfPolicy parameter to specify 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. |
ResourceDelegates |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Use the ResourceDelegates parameter to specify a list of users who are resource mailbox delegates. Resource mailbox delegates can approve or reject requests sent to this resource mailbox. |
ScheduleOnlyDuringWorkHours |
Optional |
System.Boolean |
Use the ScheduleOnlyDuringWorkHours parameter to specify whether to allow meetings to be scheduled outside work hours. |
TentativePendingApproval |
Optional |
System.Boolean |
Set the TentativePendingApproval parameter to $true to mark pending requests as tentative on the calendar. If set to $false, pending requests are marked as free. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Example
This example configures the mailbox 5th Floor Conference Room to automatically accept meeting requests. It also replaces the subject line of meeting requests with the name of the meeting organizer.
Set-MailboxCalendarSettings -Identity "5th Floor Conference Room" -AutomateProcessing AutoAccept -AddOrganizerToSubject $true -DeleteSubject $true