Resume-StorageGroupCopy

  • Article

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Resume-StorageGroupCopy cmdlet to resume replication and replay activities (log copying and replay) for a storage group that is enabled for local continuous replication (LCR) or cluster continuous replication (CCR). This cmdlet can also be used to resume replication and replay activities for a storage group enabled for standby continuous replication (SCR).

Syntax

Resume-StorageGroupCopy -Identity <StorageGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-StandbyMachine <String>] [-WhatIf [<SwitchParameter>]]

Detailed Description

An Exchange administrator may periodically need to resume replication activities on a server where the activities had previously been suspended to reseed the server, perform a physical consistency check, permit data reconfiguration on the server, or for other reasons.

Note

We recommend that you minimize the amount of time that a storage group is suspended. The system is exposed to a longer outage or more data loss in the case of a failure when the storage group is suspended.

To successfully initiate a Resume-StorageGroupCopy operation, the following must be true:

  • The storage group must be enabled for LCR, CCR, or SCR.

  • The user must use an account that is delegated the Exchange Server Administrator role and local Administrators group for the specified server. For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

The Resume-StorageGroupCopy cmdlet can be run successfully on a storage group copy that is currently resumed. The Resume-StorageGroupCopy cmdlet can be run from an administrative workstation.

After a Resume-StorageGroupCopy operation has completed, the following are true:

  • The storage group copy replication is resumed and reports a resumed status.

  • An event is recorded in the event log showing the storage group copy has resumed.

  • The suspend comment is cleared, as reported by the Get-StorageGroupCopyStatus cmdlet.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

The Identity parameter takes one of the following values:

  • GUID

  • Name of the storage group

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.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that the task will use.

StandbyMachine

Optional

System.String

The StandbyMachine parameter parameter specifies the name of the Mailbox server on which the SCR target is being resumed. This parameter must be used when resuming an SCR target. If this parameter is not specified, the local LCR or CCR copy for the specified storage group will be resumed.

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.

Errors

Error Description

Cannot query cluster continuous replication status on a non-cluster server. <ServerName> is not on a clustered mailbox server.

This task can only be run against a clustered mailbox server.

Server '<CMSName>' is not available. The cluster may be unavailable or a communication problem may exist. This task cannot complete without communicating with the cluster.

The task was unable to connect to the cluster due to a communication issue, or the cluster is not available.

This situation may be because the node is unavailable, the node is available and the cluster is unavailable, or the computer being used cannot access a node or computer.

The Mailbox role is not configured on node <Node>.

The Mailbox server role is not installed on this node.

Example

The first example shows how the Resume-StorageGroupCopy cmdlet is used to resume replication operations for a storage group named SG1 on server MBX.

The second example shows how to resume replication activity for an SCR target on Server2 for a storage group named SG1.

Resume-StorageGroupCopy -Identity MBX\SG1
Resume-StorageGroupCopy -Identity MBX\SG1 -StandbyMachine Server2