Applies to: Exchange Server 2013

Topic Last Modified: 2012-09-08

Use the Set-MailboxDatabase cmdlet to configure a variety of properties for a mailbox database.

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax


Set-MailboxDatabase -Identity <DatabaseIdParameter> [-AllowFileRestore <$true \| $false>] [-AutoDagExcludeFromMonitoring <$true \| $false>] [-AutoDatabaseMountDial <Lossless \| GoodAvailability \| BestAvailability>] [-BackgroundDatabaseMaintenance <$true \| $false>] [-CalendarLoggingQuota <Unlimited>] [-CircularLoggingEnabled <$true \| $false>] [-Confirm [<SwitchParameter>]] [-DataMoveReplicationConstraint <None \| SecondCopy \| SecondDatacenter \| AllDatacenters \| AllCopies \| CINoReplication \| CISecondCopy \| CISecondDatacenter \| CIAllDatacenters \| CIAllCopies>] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true \| $false>] [-IsExcludedFromInitialProvisioning <$true \| $false>] [-IsExcludedFromProvisioning <$true \| $false>] [-IssueWarningQuota <Unlimited>] [-IsSuspendedFromProvisioning <$true \| $false>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true \| $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RecoverableItemsQuota <Unlimited>] [-RecoverableItemsWarningQuota <Unlimited>] [-RetainDeletedItemsUntilBackup <$true \| $false>] [-WhatIf [<SwitchParameter>]]

Set-MailboxDatabase -Identity <DatabaseIdParameter>
[-AllowFileRestore <$true | $false>]
[-AutoDagExcludeFromMonitoring <$true | $false>]
[-AutoDatabaseMountDial <Lossless | GoodAvailability |
BestAvailability>] [-BackgroundDatabaseMaintenance <$true |
$false>] [-CalendarLoggingQuota <Unlimited>]
[-CircularLoggingEnabled <$true | $false>] [-Confirm
[<SwitchParameter>]] [-DataMoveReplicationConstraint <None
| SecondCopy | SecondDatacenter | AllDatacenters | AllCopies |
CINoReplication | CISecondCopy | CISecondDatacenter |
CIAllDatacenters | CIAllCopies>] [-DeletedItemRetention
<EnhancedTimeSpan>] [-DomainController <Fqdn>]
[-EventHistoryRetentionPeriod <EnhancedTimeSpan>]
[-IndexEnabled <$true | $false>]
[-IsExcludedFromInitialProvisioning <$true | $false>]
[-IsExcludedFromProvisioning <$true | $false>]
[-IssueWarningQuota <Unlimited>]
[-IsSuspendedFromProvisioning <$true | $false>]
[-JournalRecipient <RecipientIdParameter>] [-MailboxRetention
<EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>]
[-MountAtStartup <$true | $false>] [-Name <String>]
[-OfflineAddressBook <OfflineAddressBookIdParameter>]
[-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota
<Unlimited>] [-PublicFolderDatabase
<DatabaseIdParameter>] [-QuotaNotificationSchedule
<Schedule>] [-RecoverableItemsQuota <Unlimited>]
[-RecoverableItemsWarningQuota <Unlimited>]
[-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf
[<SwitchParameter>]]

Examples

EXAMPLE 1

This example sets the length of time that deleted items are retained. If a specific mailbox has its own item retention set, that value is used instead of this value, which is set on the mailbox database.

	Copy Code
Set-MailboxDatabase "Mailbox Database01" -DeletedItemRetention 7.00:00:00

Detailed Description

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 "Mailbox Database Permissions" section in the Recipients Permissions topic.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

The Identity parameter specifies the mailbox database for which you want to set one or more attributes. You can use the following values:

GUID
Distinguished name (DN)
Name of the mailbox database

If you don't specify the server name, the command searches for the database on the local server.

AllowFileRestore

Optional

System.Boolean

The AllowFileRestore parameter specifies whether to allow restoring a database from a backup. The two possible values are $true or $false. If you specify $true, the command allows a database that doesn't match the database entry in Active Directory to be mounted. If you specify $false, the command doesn't allow a database that doesn't match the database entry in Active Directory to be mounted, so you won't be able to replace an existing database with a newly created database.

AutoDagExcludeFromMonitoring

Optional

System.Boolean

The AutoDagExcludedFromMonitoring parameter replaces the mechanism used in Exchange 2010 to exclude a mailbox database from the Database One Copy Alert script that alerts an administrator when a replicated database has only one healthy copy available. If this property is not set to True for a database and there is only one copy of the database, alerts will be issued.

AutoDatabaseMountDial

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AutoDatabaseMountDial

This parameter is reserved for internal Microsoft use.

BackgroundDatabaseMaintenance

Optional

System.Boolean

The BackgroundDatabaseMaintenance parameter specifies whether the Extensible Storage Engine (ESE) performs database maintenance. The two possible values are $true or $false. If you specify $true, the mailbox database reads the object during database mount and initializes the database to perform the background database maintenance. If you specify $false, the mailbox database reads the object during database mount and initializes the database without the option to perform the background database maintenance.

CalendarLoggingQuota

Optional

Microsoft.Exchange.Data.Unlimited

The CalendarLoggingQuota parameter specifies how much space to allocate for calendar logging information.

CircularLoggingEnabled

Optional

System.Boolean

The CircularLoggingEnabled parameter specifies whether circular logging is enabled. If this parameter is set to $true, circular logging is enabled. The default value is $false.

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.

DataMoveReplicationConstraint

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.DataMoveReplicationConstraintParameter

The DataMoveReplicationConstraint parameter specifies the throttling behavior for high availability mailbox moves. The possible values include:

None Moves shouldn't be throttled to ensure high availability. Use this setting if the database isn't part of a database availability group (DAG).
SecondCopy At least one passive mailbox database copy must have the most recent changes synchronized. This is the default value. Use this setting to indicate that the database is replicated to one or more mailbox database copies.
SecondDatacenter At least one passive mailbox database copy in another Active Directory site must have the most recent changes replicated. Use this setting to indicate that the database is replicated to database copies in multiple Active Directory sites.
AllDatacenters At least one passive mailbox database copy in each Active Directory site must have the most recent changes replicated. Use this setting to indicate that the database is replicated to database copies in multiple Active Directory sites.
AllCopies All copies of the database must have the most recent changes replicated. Use this setting to indicate that the database is replicated to one or more mailbox database copies.

Note:
Any value other than `None` enables the Microsoft Exchange Mailbox Replication service to coordinate with Active Manager. For more information, see Active Manager.

DeletedItemRetention

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The DeletedItemRetention parameter specifies the length of time to keep deleted items.

To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds.

For example, to specify a 15-hour interval, enter 15:00:00. The maximum length of time to retain deleted items is 24,855 days. By default, deleted items are retained for 14 days. This attribute applies to all mailboxes in this mailbox database that don't have their own item retention attribute set.

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.

EventHistoryRetentionPeriod

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The EventHistoryRetentionPeriod parameter specifies the length of time to keep event data. This event data is stored in the event history table in the Exchange store. It includes information about changes to various objects in the mailbox database. You can use this parameter to prevent the event history table from becoming too large and using too much disk space.

To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds.

For example, to specify a 15-hour interval, enter 15:00:00.

IndexEnabled

Optional

System.Boolean

The IndexEnabled parameter specifies whether Exchange Search indexes this mailbox database. The two possible values are $true or $false. The default value is $true.

IsExcludedFromInitialProvisioning

Optional

System.Boolean

The IsExcludedFromInitialProvisioning parameter specifies that this database is temporarily not considered by the mailbox provisioning load balancer. If the IsExcludedFromInitialProvisioning parameter is enabled, new mailboxes aren't added automatically to this database.

IsExcludedFromProvisioning

Optional

System.Boolean

The IsExcludedFromProvisioning parameter specifies that this database is permanently not considered by the mailbox provisioning load balancer. If the IsExcludedFromProvisioning parameter is enabled, new mailboxes aren't added automatically to this database. You can manually add a mailbox if your role permits.

IssueWarningQuota

Optional

Microsoft.Exchange.Data.Unlimited

The IssueWarningQuota parameter specifies the mailbox size at which a warning message is sent to the user.

This attribute applies to all mailboxes in this mailbox database that don't have their own warning quota attribute set. You must specify either an integer or unlimited. The default value is 1.9 gigabytes (GB).

IsSuspendedFromProvisioning

Optional

System.Boolean

The IsSuspendedFromProvisioning parameter specifies that this database is temporarily not considered by the mailbox provisioning load balancer.

JournalRecipient

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

The JournalRecipient parameter specifies the mailbox to which journal reports are sent.

MailboxRetention

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The MailboxRetention parameter specifies the length of time to keep deleted mailboxes.

To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds.

For example, to specify a 15-hour interval, enter 15:00:00. The maximum length of time to retain mailboxes is 24,855 days. By default, deleted mailboxes are retained for 30 days. This attribute applies to all mailboxes in this mailbox database.

MaintenanceSchedule

Optional

Microsoft.Exchange.Data.Schedule

This parameter has been deprecated in Exchange 2013 and it no longer does anything.

MountAtStartup

Optional

System.Boolean

The MountAtStartup parameter specifies whether to mount this mailbox database when the Microsoft Exchange Information Store service starts. The two possible values for this parameter are $true or $false.

Name

Optional

System.String

The Name parameter specifies the name of the mailbox database.

OfflineAddressBook

Optional

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

The OfflineAddressBook parameter specifies the associated address book for this mailbox database.

ProhibitSendQuota

Optional

Microsoft.Exchange.Data.Unlimited

The ProhibitSendQuota parameter specifies the mailbox size at which users associated with mailboxes in this mailbox database can no longer send messages. This attribute applies to all mailboxes in this mailbox database that don't have their own prohibit send quota attributes set.

You must specify either an integer or unlimited.

ProhibitSendReceiveQuota

Optional

Microsoft.Exchange.Data.Unlimited

The ProhibitSendReceiveQuota parameter specifies the mailbox size at which the user associated with this mailbox can no longer send or receive messages. This attribute applies to all mailboxes in this mailbox database that don't have their own prohibit send receive quota attributes set.

You must specify either an integer or unlimited.

PublicFolderDatabase

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

This parameter has been deprecated in Exchange 2013 and it no longer does anything.

QuotaNotificationSchedule

Optional

Microsoft.Exchange.Data.Schedule

This parameter has been deprecated in Exchange 2013 and it no longer does anything.

RecoverableItemsQuota

Optional

Microsoft.Exchange.Data.Unlimited

The RecoverableItemsQuota parameter specifies the limit for the Recovery Items folder. When you reach the quota limit, you can't put any more items in the Recovery Items folder.

RecoverableItemsWarningQuota

Optional

Microsoft.Exchange.Data.Unlimited

The RecoverableItemsWarningQuota parameter specifies the quota for when a warning event is entered in Event Viewer.

RetainDeletedItemsUntilBackup

Optional

System.Boolean

The RetainDeletedItemsUntilBackup parameter specifies whether to retain deleted items until the next backup occurs. The two possible values for this parameter are $true or $false.

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.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.