New-MailboxDatabase (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
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> [-CopyEdbFilePath <EdbFilePath>] [-DomainController <Fqdn>] [-EdbFilePath <EdbFilePath>] [-HasLocalCopy <$true | $false>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-PublicFolderDatabase <DatabaseIdParameter>] [-TemplateInstance <PSObject>]
New-MailboxDatabase [-Name <String>] -MailboxDatabaseToRecover <DatabaseIdParameter> -StorageGroup <StorageGroupIdParameter> [-DomainController <Fqdn>] [-EdbFilePath <EdbFilePath>] [-TemplateInstance <PSObject>]
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.
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. |
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. |
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.
New-MailboxDatabase -StorageGroup "Server01.contoso.com\First Storage Group" -Name "MailboxDatabase01" -EdbFilePath D:\DatabaseFiles\MailboxDatabase01.edb