Set-MailboxCalendarSettings

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

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[]>] [-Confirm [<SwitchParameter>]] [-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>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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[]>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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 that you use must be delegated the following:

• Exchange Organization Administrator role

For more information about permissions, about delegating roles, and about 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 for which meetings are allowed to be booked in advance. Valid input is an integer from 0 through 1080. When the value is set to 0, the Booking Window for accepting meetings defaults to the current day. The meeting cannot be booked on a future date.
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.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm parameter 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 parameter.
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.
IgnoreDefaultScope	Optional	System.Management.Automation.SwitchParameter	The IgnoreDefaultScope parameter instructs the command to ignore the default recipient scope setting for the Exchange Management Shell and use the entire forest as the scope. This allows the command to access Active Directory objects that are not currently in the default scope. Using the IgnoreDefaultScope parameter introduces the following restrictions: You cannot use the DomainController parameter. The command will use 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, are not accepted.
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.
UseRusServer	Optional	System.String	Note: This parameter is available only in Exchange 2007 SP2. The UseRusServer parameter instructs the command to use the specified Mailbox server on which the Address List service is running to obtain and then set mailbox and Active Directory user attributes. The Address List service is a component in the Exchange System Attendant service. The Address List service creates and maintains Exchange-specific attribute values in Active Directory. You can use the Address List service to update recipient objects in a domain by using specific information, such as address list membership and e-mail addresses.
WhatIf	Optional	System.Management.Automation.SwitchParameter	The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, 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 parameter.

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 substitutes the name of the meeting organizer for the subject line of meeting requestsh.

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