[
This topic's current status is: Content Complete.]
Applies to: Exchange Server 2010
Topic Last Modified: 2009-07-14
Use the New-MailboxDatabase cmdlet to create a mailbox database object in the database container in Active Directory.
Syntax
New-MailboxDatabase -Name <String> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EdbFilePath <EdbFilePath>] [-IsExcludedFromProvisioning <$true | $false>] [-IsSuspendedFromProvisioning <$true | $false>] [-LogFolderPath <NonRootLocalLongFullPath>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-PublicFolderDatabase <DatabaseIdParameter>] [-WhatIf [<SwitchParameter>]]
New-MailboxDatabase [-Name <String>] -Recovery <SwitchParameter> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EdbFilePath <EdbFilePath>] [-LogFolderPath <NonRootLocalLongFullPath>] [-WhatIf [<SwitchParameter>]]
Parameters
|
Parameter
|
Required
|
Type
|
Description
|
|---|
|
Name
|
Required
|
System.String
|
The Name parameter specifies the name of the new mailbox database.
|
|
Recovery
|
Required
|
System.Management.Automation.SwitchParameter
|
The Recovery parameter specifies that the new database is designated as a recovery database.
|
|
Server
|
Required
|
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter
|
The Server parameter specifies the server you want to create the database on.
|
|
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.
|
|
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.
|
|
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.
|
|
IsExcludedFromProvisioning
|
Optional
|
System.Boolean
|
The IsExcludedFromProvisioning parameter specifies that this database isn't considered by the mailbox provisioning load balancer. If the IsExcludedFromProvisioning parameter is set to $true, no new mailboxes are automatically added to this database.
|
|
IsSuspendedFromProvisioning
|
Optional
|
System.Boolean
|
The IsSuspendedFromProvisioning parameter specifies that this database isn't temporarily considered by the mailbox provisioning load balancer.
|
|
LogFolderPath
|
Optional
|
Microsoft.Exchange.Data.NonRootLocalLongFullPath
|
The LogFolderPath parameter specifies the folder location for log files.
|
|
OfflineAddressBook
|
Optional
|
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter
|
The OfflineAddressBook parameter specifies the associated offline address book (OAB) 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.
|
|
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.
|
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" entry in the Mailbox Permissions topic.
Input Types
Return Types
Errors
Exceptions
Examples
Example 1
This example creates the mailbox database MailboxDatabase01. This example also specifies where to create the .edb database file.
New-MailboxDatabase -Name "MailboxDatabase01" -EdbFilePath D:\DatabaseFiles\MailboxDatabase01.edb