Share via


Disable-StorageGroupCopy

 

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

This topic explains how to use the Disable-StorageGroupCopy cmdlet to disable local continuous replication (LCR) and remove the passive copy of a storage group and its database, as well as all configuration information associated with the passive copy, from a Mailbox server running Microsoft Exchange Server 2007.

This topic also explains how to use the Disable-StorageGroupCopy cmdlet to disable standby continuous replication (SCR) and remove an SCR target storage group and its database and configuration information from a Mailbox server running Microsoft Exchange Server 2007 Service Pack 1 (SP1).

Syntax

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

Detailed Description

An Exchange administrator may want to disable LCR or SCR for a storage group. After a Disable-StorageGroupCopy operation has completed, the configuring settings for the passive copy of the storage group are removed.

Note

This cmdlet disables continuous replication, but it does not remove any storage group files or the database file from the copy of the storage group. An administrator must manually remove these files from the file system.

To run the Disable-StorageGroupCopy cmdlet, 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 2007, see Permission Considerations.

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

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that locates the clustered mailbox server in the Active Directory directory service, include the DomainController parameter in the command.

StandbyMachine

Optional

System.String

The StandbyMachine parameter is a new parameter added in Exchange 2007 SP1. This parameter is used to specify the name of a server that is being disabled as a target for SCR. This parameter must be used when disabling an SCR target. If this parameter is not specified, the local LCR or cluster continuous replication (CCR) copy for the specified storage group will be disabled.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You do not have to specify a value with the WhatIf parameter.

Errors

Error Description

'SGName' does not have local continuous replication enabled.

The storage group does not have LCR enabled.

The storage group that you specified is a recovery storage group. This task cannot be used with recovery storage groups. Specified storage group: {0}

The operation cannot be performed on a recovery storage group.

Example

The first example shows a Disable-StorageGroupCopy command where LCR for a storage group named SG1 is disabled.

The second example shows how to disable an SCR target on a server named Server2 for a storage group named SG1.

Disable-StorageGroupCopy -Identity SG1
Disable-StorageGroupCopy -Identity SG1 -StandbyMachine Server2