Enable-ContinuousReplicationHostName

 

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

Use the Enable-ContinuousReplicationHostName cmdlet to create a Network Name and IP Address resource in a dedicated cluster group that is owned by only one node in the cluster. This Network Name and IP Address can then be used for log shipping and seeding in a cluster continuous replication (CCR) environment.

Syntax

Enable-ContinuousReplicationHostName [-Identity <MailboxServerIdParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HostName <String>] [-IPv4Address <IPAddress>] [-TargetMachine <String>] [-WhatIf [<SwitchParameter>]]

Detailed Description

To run the Enable-ContinuousReplicationHostName cmdlet, the account you use must be delegated the Exchange Server Administrator and local Administrator rights on the cluster node. For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

The Enable-ContinuousReplicationHostName cmdlet creates a new cluster group that will contain the IP Address and Network Name resources that are specified using the cmdlet parameters. The names for the new cluster group and the network name depend on the specified parameters:

  • If the -HostName parameter is not specified, the name of the cluster group will be NodeNamepriv0_group and the Network Name will be NodeNamepriv0.

  • If the -HostName parameter is specified, the name of the cluster group will be HostName_group and the Network Name will be HostName.

For continuous replication to use an alternate network, the Enable-ContinuousReplicationHostName cmdlet must be run on both nodes in the cluster, and the groups that are created will contain a unique IP Address and Network Name resource for each node. After the cmdlet has been run on both nodes, and after the new cluster groups are created and brought online, the newly created network will be used for copying log files.

Parameters

Parameter Required Type Description

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

The DomainController parameter is used to specify the fully qualified domain name (FQDN) of the domain controller that will be used to retrieve data from the directory service.

HostName

Optional

System.String

The HostName parameter specifies the network name being created on the local node. If this parameter is not specified, and if the name of the node being enabled (for example, the TargetMachine) is 15 characters or less, the cluster group and Network Name resource created by the task will use the TargetMachine computer name as part of its name.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter

The Identity parameter specifies the clustered mailbox server associated with the local node. The local node can be either an active or a passive node.

IPv4Address

Optional

System.Net.IPAddress

The IPv4Address parameter specifies a new static Internet Protocol version 4 (IPv4) address that will be paired with the value of the HostName parameter on the local node.

TargetMachine

Optional

System.String

The TargetMachine parameter specifies the name of the cluster node that will own the HostName and associated IP Address resource. If this parameter is not specified, the local node will be used.

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.

Input Types

Return Types

Errors

Error Description

At least one IP address must be specified to configure the continuous replication host name.

This task requires you to specify at least one IP address for use by the continuous replication host name.

The machine <Name> is not a member of the cluster <ClusterName>.

This error occurs if the computer specified by the -TargetMachine parameter is not a member of the local cluster. To enable a continuous replication host name for the computer specified by the -TargetMachine parameter, you must run this task locally on that computer.

IPv4Address parameter is mandatory on Windows Server 2003 clusters.

This task requires a value for the IPv4Address parameter when it is run on a node in a Windows Server 2003 failover cluster.

The target machine name <Name> is too long to derive a default continuous replication host name. Please explicitly specify one with the -HostName parameter.

This error indicates that the name of the specified target computer is too long to use as part of the continuous replication host name. In this case, you must rerun this task and explicitly specify the continuous replication host name by using the -HostName parameter.

The host machine name <Name> is too long to be a continuous replication host name. The maximum length is <Length>.

This error occurs if the value specified for the -HostName parameter is greater than 15 characters. The maximum length for a continuous replication host name is 15 characters.

The cluster group for network name <Name> was not found.

This error occurs if the name specified by the -HostName parameter does not exist.

A resource with network name <Name> already exists in group <Group>.

This error indicates that a Network Name resource with the name specified by the -HostName parameter already exists. You must use a unique value for the -HostName parameter on each node.

Could not derive a suitable network name for the host <HostName>. Please explicitly specify one with the -HostName parameter.

This error indicates that the system was unable to create a Network Name resource using the specified host name. In this case, you must rerun this task and explicitly specify the continuous replication host name by using the -HostName parameter.

The group <Name> already exists.

This error indicates that a resource group exists with the same name as the intended group for the continuous replication host name.

The resource <Name> already exists.

This error indicates that a Network Name resource exists with the same name as the intended continuous replication host name.

Example

The first example shows how to enable a continuous replication host name called NODE1NET on a node called NODE1 that uses an IPv4 address of 192.168.100.5. This task results in the creation of a cluster resource group called NODE1NET_group that contains an IP Address resource (192.168.100.5) and a Network Name resource (NODE1NET).

The second example shows how to enable a continuous replication host name called NODE2NET on a node called NODE2 that uses an IPv4 address of 192.168.100.6. This task results in the creation of a cluster resource group called NODE2NET_group that contains an IP Address resource (192.168.100.6) and a Network Name resource (NODE2NET).

Enable-ContinuousReplicationHostName -TargetMachine NODE1 -HostName NODE1NET -IPv4Address 192.168.100.5
Enable-ContinuousReplicationHostName -TargetMachine NODE2 -HostName NODE2NET -IPv4Address 192.168.100.6