Share via


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

noteNote:
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