Applies to: Exchange Server 2007
Topic Last Modified: 2007-08-06
Use the Move-DatabasePath cmdlet to set a new path to the location of a database on the specified Mailbox server and to move the related files to that location.
Syntax
Move-DatabasePath -Identity <DatabaseIdParameter>
[-ConfigurationOnly <SwitchParameter>] [-CopyEdbFilePath
<EdbFilePath>] [-DomainController <Fqdn>] [-EdbFilePath
<EdbFilePath>] [-Force <SwitchParameter>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
The Identity parameter specifies the GUID, distinguished name (DN), or name of the database.
|
|
ConfigurationOnly |
Optional |
System.Management.Automation.SwitchParameter |
The ConfigurationOnly parameter changes the configuration
of the database without moving any files. A value of
|
|
CopyEDBFilePath |
Optional |
Microsoft.Exchange.Data.EdbFilePath |
The CopyEDBFilePath parameter specifies a new file path for the backup copy of the database. This file path cannot be the same as the EDBFilePath. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter in the command. |
|
EDBFilePath |
Optional |
Microsoft.Exchange.Data.EdbFilePath |
The EDBFilePath parameter specifies a new file path for the database. All current database files are moved to this location. The default location is <ExchangeInstallDirectory>\Mailbox\LocalCopies\Storage Group\MBDatabase.edb. This file path cannot be the same as the path for the backup copy of the database. |
|
Force |
Optional |
System.Management.Automation.SwitchParameter |
Include the Force parameter to force the command to execute without asking for user confirmation. |
Detailed Description
Use the Move-DatabasePath cmdlet to set a new path to the location of a database on the specified Mailbox server and move the related files to that location. This cmdlet is valid only for Microsoft Exchange Server 2007 Mailbox servers.
When you use the Move-DatabasePath cmdlet, consider the following:
- This cmdlet fails if it is run while the database is being
backed up.
- If the specified database is mounted when this cmdlet is run,
the database will be automatically dismounted and then remounted,
and will be unavailable to users while it is dismounted.
- In a cluster continuous replication (CCR) environment, the
second copy of the data must be moved manually.
- This command can be run on the affected Mailbox server only,
except that it can be run on an administrator's workstation when
you are using the ConfigurationOnly parameter.
To run the Move-DatabasePath 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 Exchange Server 2007, see Permission Considerations.
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
In the first example, the Move-DatabasePath command is used to set a new path for the mailbox database specified by the GUID.
In the second example, the Move-DatabasePath command is used to set a new path for the mailbox database specified by the database name, using the Identity parameter format Server Name\Storage Group\Database.
 Copy Code |
|
|---|---|
Move-DatabasePath -Identity a0ec9f03-12a9-4e40-9310-43f9105fd4d2 -EdbFilePath C:\NewFolder\MyDatabase.edb Move-DatabasePath -Identity "ExchangeServer2.Contoso.com\First Storage Group\Mailbox Database 2" -EdbFilePath "C:\NewFolder\Mailbox Database 2.edb" |
|
To perform the move operation, the database must be temporarily dismounted, making it inaccessible to all users. If the database is currently dismounted, it is not remounted upon completion.