Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05

Use the Suspend-StorageGroupCopy cmdlet to block replication and replay activities (log copying and replaying of logs) for a specified storage group copy of a server running Microsoft Exchange Server 2007.

Syntax

Suspend-StorageGroupCopy -Identity <StorageGroupIdParameter> [-DomainController <Fqdn>] [-SuspendComment <String>]

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 locates the clustered mailbox server in the Active Directory directory service.

SuspendComment

Optional

System.String

The SuspendComment parameter specifies the reason that the replay or copy of log files was suspended. This parameter is limited to 512 characters.

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

An Exchange administrator may periodically need to suspend replication and replay activities on a server. The administrator may want to do this to perform an administrative action or to permit data reconfiguration on the server.

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

  • The storage group copy must be defined.

  • The user must use an account that is delegated 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.

  • In a cluster continuous replication (CCR) configuration, the cluster must have a quorum.

After a Suspend-StorageGroupCopy operation has completed, the following occurs:

  • There is no further I/O activity on the storage group copy.

  • The storage group copy is suspended and reports a suspended status.

  • An event is recorded in the event log stating a specific reason. If the task is run when the storage group copy is suspended, no error is generated.

    Note:
    The task does not complete until the replication engine acknowledges and completes the suspend operation. If the replication engine is unavailable, this task may indefinitely block the shell. If the shell blocks for more than 45 seconds, close it and verify the storage group copy is suspended with Get-StorageGroupCopyStatus.

The task can be run from an administrative workstation.

Errors

Error Description

Continous replication is not configured on <StorageGroupName>.

This task cannot be used on a storage group that is not configured with continuous replication either via local continuous replication (LCR) or CCR.

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 because the cluster is not available.

This 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 following example shows how to suspend replication activities for a storage group named SG1 on server mailboxsvr1 while the log files are moved to a new location. If you have more than one server, you must specify the server within the Identity argument as shown in the following example. If you only have one server, you do not need to specify the server.

Copy Code
Suspend-StorageGroupCopy -Identity:mailboxsvr1\SG1 -SuspendComment:"Moving log files to new location"