Applies to: Exchange Server 2007
Topic Last Modified: 2007-08-29
Use the Update-StorageGroupCopy cmdlet to initiate or resynchronize replication for a specified Microsoft Exchange Server 2007 cluster continuous replication (CCR) or local continuous replication (LCR) database copy.
Syntax
Update-StorageGroupCopy -Identity
<StorageGroupIdParameter> [-DeleteExistingFiles
<SwitchParameter>] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-ManualResume <SwitchParameter>]
[-TargetPath <LocalLongFullPath>]
|
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter |
The Identity parameter takes one of the following values:
|
Confirm |
Optional |
Boolean |
The Confirm parameter causes the command to pause processing and requires the administrator to acknowledge what the command will do before processing continues. The default value is $true. |
DeleteExistingFiles |
Optional |
System.Management.Automation.SwitchParameter |
The DeleteExistingFiles parameter causes the command to remove the logs, checkpoint, and database files at the target location. It removes only the files that it checks for and fails if other files are present. No action is taken on other files at the target location. Therefore, if other files are present, you must manually remove them. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter can be used in the cmdlet to specify the fully qualified domain name (FQDN) of the domain controller that is used to access the storage group object. |
Force |
Optional |
System.Management.Automation.SwitchParameter |
The Force parameter can be used when the task is run programmatically and prompting for administrative input is inappropriate. If Force is not provided in the cmdlet, administrative input is prompted. If Force is provided in the cmdlet, but the value is omitted, its default value is $true. |
ManualResume |
Optional |
System.Management.Automation.SwitchParameter |
Use the ManualResume parameter when you do not want the Update-StorageGroupCopy cmdlet to automatically resume replication on the storage group copy. This parameter allows you to manually resume replication to the storage group copy. |
TargetPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The TargetPath parameter specifies the location for the database file. This is the directory that will contain the database. The last part of the path is determined by the source's base name. |
WhatIf |
Optional |
Boolean |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, the administrator can view what changes would occur without having to apply any of those changes. The default value is $true. |
Detailed Description
The Update-StorageGroupCopy cmdlet allows you to manually initiate or resynchronize replication for a CCR or LCR copy. The cmdlet automatically resumes replication to the storage group copy. If you choose to manually resume replication, you can run the cmdlet with the ManualResume parameter.
This operation should be performed in the following situations:
- You have created a storage group copy in LCR that does not have
a baseline database.
- You have a corrupted database in the CCR or LCR copy.
- You enabled an LCR copy remotely that previously was backed up
and therefore does not have all the logs.
- You have a CCR or LCR environment and need to get a new
baseline database to the passive copy. This situation could be due
to corruption, some configuration change, server loss, or invalid
baseline database available on the passive copy.
- You have run an offline defragmentation on the production
database.
Note: |
---|
If the target path is not specified, the command must be issued on the computer containing the copy. |
Note: |
---|
The command does not allow any backups (Volume Shadow Copy Service or legacy streaming backups) to be running on the same storage group. |
Important: |
---|
If communication is lost with the active copy, or it fails, the operation must be completely restarted. |
Important: |
---|
You must verify that there is sufficient space prior to initializing the cmdlet because there is no automatic check. Using the DeleteExistingFiles parameter requires space for two copies of the database on the target volume because the existing database is not deleted until a new database is successfully created. |
Caution: |
---|
The Update-StorageGroupCopy cmdlet may affect available network bandwidth and may have some effect on the production server's performance. |
The Update-StorageGroupCopy cmdlet requires that no Exchange files exist in the target location when it is run, and that the storage group copy has replication activity suspended. Use the Suspend-StorageGroupCopy cmdlet to suspend the storage group copy. After the seed is successfully completed, replication to the storage group copy is automatically restarted unless the ManualResume parameter is specified.
To use the Update-StorageGroupCopy cmdlet on a computer that has a clustered mailbox server installed, the account you use must be delegated the 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.
Errors
Error | Description |
---|---|
|
The task was unable to connect to the server due a communication issue. |
|
The storage group must be suspended before it can be seeded. |
|
This task must be run on the passive copy if the TargetPath parameter is omitted. |
|
LCR and CCR are only supported in Exchange 2007. |
|
User does not have Exchange Server Administrator authority on the specified server. |
|
The specified identity does not exist. |
|
The storage group specified is not configured to support replication. |
|
Log files and a database were not deleted prior to running an update without a target path. Delete the log, database, checkpoint, and .jtx files in the target location or specify the -DeleteExistingFiles option. |
|
Production database is not mounted. Mount the database, and reissue the task. |
|
The specified path is not available or writable. |
|
The source database already has a backup in progress. |
|
Lost communication with the source. The update was terminated. |
|
Seeding failed due to one of the following conditions:
|
|
The action failed to create a directory required to host the database. |
Example
The following example shows how to reseed the storage group named SG1 on Server1.
Copy Code | |
---|---|
Update-StorageGroupCopy -Identity:Server1\SG1 |