Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-07-31

Use the New-MailboxDatabase cmdlet to create a mailbox database object in the Storage Group container under the specified server object.

Syntax

New-MailboxDatabase -Name <String> -StorageGroup <StorageGroupIdParameter> [-Confirm [<SwitchParameter>]] [-CopyEdbFilePath <EdbFilePath>] [-DomainController <Fqdn>] [-EdbFilePath <EdbFilePath>] [-HasLocalCopy <$true | $false>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-PublicFolderDatabase <DatabaseIdParameter>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
New-MailboxDatabase [-Name <String>] -MailboxDatabaseToRecover <DatabaseIdParameter> -StorageGroup <StorageGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EdbFilePath <EdbFilePath>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

MailboxDatabaseToRecover

Required

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

The MailboxDatabaseToRecover parameter specifies the mailbox database that you want to recover to the new database. This parameter is only required if you are recovering a mailbox database.

Name

Required

System.String

The Name parameter specifies the name of the new mailbox database.

StorageGroup

Required

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

The StorageGroup parameter specifies the name of the storage group where the mailbox database will be created.

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 do not have to specify a value with the Confirm parameter.

CopyEdbFilePath

Optional

Microsoft.Exchange.Data.EdbFilePath

The CopyEdbFilePath parameter specifies the path to the copy of the .edb file. The default value is %programfiles%\Microsoft\Exchange Server\LocalCopies\<Storage Group name>\<Database name>.edb.

If specified, the HasLocalCopy parameter must be set to $true.

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.

EdbFilePath

Optional

Microsoft.Exchange.Data.EdbFilePath

The EdbFilePath parameter specifies the path to the .edb file. The default value is %programfiles%\Microsoft\Exchange Server\Mailbox\<Storage Group name>\<Database name>.edb.

HasLocalCopy

Optional

System.Boolean

The HasLocalCopy parameter specifies whether a copy of the database will be created at the location specified in the CopyEdbFilePath parameter. The two possible values for this parameter are $true or $false.

Note:
Cluster continuous replication (CCR) and local continuous replication (LCR) allow only one database per storage group. If you specify the CopyEdbFilePath parameter as $true, you must create the new mailbox database on a storage group that does not already have a database.

OfflineAddressBook

Optional

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

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

PublicFolderDatabase

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

The PublicFolderDatabase parameter specifies the associated public folder database for the new mailbox database.

TemplateInstance

Optional

System.Management.Automation.PSObject

When an existing object is supplied to the TemplateInstance parameter, the command will use that object's configuration to create an exact duplicate of the object on a local or target server. For more information, see Templates.

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 do not have to specify a value with the WhatIf parameter.

Detailed Description

To run the New-MailboxDatabase cmdlet, the account you use must be delegated the following:

  • Exchange Server Administrator role and local Administrators group for the target server

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Input Types

Return Types

Errors

Error Description

 

Exceptions

Exceptions Description

 

Example

The following example shows how to create a new mailbox database named MailboxDatabase01 in the storage group named First Storage Group on the mailbox server named Server01.contoso.com. This example specifies where to create the .edb database file.

Copy Code
New-MailboxDatabase -StorageGroup "Server01.contoso.com\First Storage Group" -Name "MailboxDatabase01" -EdbFilePath D:\DatabaseFiles\MailboxDatabase01.edb