Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05

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>]

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.

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.

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.

Copy Code
Set-MailboxCalendarSettings -Identity "5th Floor Conference Room" -AutomateProcessing AutoAccept -AddOrganizerToSubject $true -DeleteSubject $true