Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Update-DatabaseSchema

 

Applies to: Exchange Server 2013

Topic Last Modified: 2013-10-14

Use the Update-DatabaseSchema cmdlet to upgrade the database schema for one or more databases after an Exchange software update that includes database schema updates has been installed on Mailbox servers in a database availability group (DAG). Some software updates for Exchange may include database schema updates. After such an update has been installed on all members of a DAG, the administrator must run the Update-DatabaseSchema cmdlet for each database in the DAG to trigger the database schema update. The in-place database schema upgrade engine ensures that no schema updates occur until all members of the DAG have compatible versions of the software.

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

Update-DatabaseSchema -Identity <DatabaseIdParameter> <COMMON PARAMETERS>
Update-DatabaseSchema -Identity <DatabaseIdParameter> -MajorVersion <UInt16> -MinorVersion <UInt16> <COMMON PARAMETERS>
COMMON PARAMETERS: [-AllowFileRestore <$true | $false>] [-AutoDagExcludeFromMonitoring <$true | $false>] [-AutoDatabaseMountDial <Lossless | GoodAvailability | BestAvailability>] [-BackgroundDatabaseMaintenance <$true | $false>] [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DatabaseGroup <String>] [-DataMoveReplicationConstraint <None | SecondCopy | SecondDatacenter | AllDatacenters | AllCopies | CINoReplication | CISecondCopy | CISecondDatacenter | CIAllDatacenters | CIAllCopies>] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IssueWarningQuota <Unlimited>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]

This example updates the database schema for database DB1.

Update-DatabaseSchema DB1

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 databases" entry in the Recipients Permissions topic.

 

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

MajorVersion

Required

System.UInt16

This parameter is reserved for internal Microsoft use.

MinorVersion

Required

System.UInt16

This parameter is reserved for internal Microsoft use.

AllowFileRestore

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

AutoDagExcludeFromMonitoring

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

AutoDatabaseMountDial

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AutoDatabaseMountDial

This parameter is reserved for internal Microsoft use.

BackgroundDatabaseMaintenance

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

CircularLoggingEnabled

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

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.

DatabaseGroup

Optional

System.String

This parameter is reserved for internal Microsoft use.

DataMoveReplicationConstraint

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.DataMoveReplicationConstraintParameter

This parameter is reserved for internal Microsoft use.

DeletedItemRetention

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter is reserved for internal Microsoft use.

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

This parameter is reserved for internal Microsoft use.

IssueWarningQuota

Optional

Microsoft.Exchange.Data.Unlimited

This parameter is reserved for internal Microsoft use.

MaintenanceSchedule

Optional

Microsoft.Exchange.Data.Schedule

This parameter has been deprecated in Exchange 2013.

MountAtStartup

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

Name

Optional

System.String

This parameter is reserved for internal Microsoft use.

QuotaNotificationSchedule

Optional

Microsoft.Exchange.Data.Schedule

This parameter has been deprecated in Exchange 2013.

RetainDeletedItemsUntilBackup

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

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.

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.

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.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.