[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Adds the local computer to the Microsoft Communications Server “14” replication path.

Syntax


Enable-CsReplica [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-NonDomain <$true \| $false>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Enable-CsReplica [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-NonDomain <$true | $false>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
NonDomain	Optional	Boolean	Set this value to True ($True) if the computer is not a member of your Active Directory domain. Edge Servers are typically not domain members.
GlobalCatalog	Optional	String	Fully qualified domain name of a global catalog server in your domain. This parameter is not required if you are running Enable-CsReplica on a computer with an account in your domain.
GlobalSettingDomainController	Optional	String	Fully qualified domain name of a domain controller where global settings are stored. If global settings are stored in the System container in Active Directory then this parameter must point to the root domain controller. If global settings are stored in the Configuration container then any domain controller can be used and this parameter can be omitted.
Report	Optional	String	Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\EnableReplica.html"
Force	Optional	Switch Parameter	Suppresses the display of any non-fatal error message that might arise when running the command.
WhatIf	Optional	Switch Parameter	Describes what would happen if you executed the command without actually executing the command.
Confirm	Optional	Switch Parameter	Prompts you for confirmation before executing the command.

Detailed Description

When a Communications Server service or server role is installed on a computer, that computer needs to be added to the replication path; doing so enables the computer to receive the topology and configuration files from the Central Management database. The Enable-CsReplica cmdlet provides a way for you to manually add a computer to the replication path.

Return Types

Enable-CsReplica does not return any values or objects.

Examples

-------------------------- Example 1 ------------------------

	Copy Code
Enable-CsReplica -NonDomain $True

The command shown in Example 1 adds the local computer to the Communications Server replication path. Because the computer in question is not a member of the domain, the –NonDomain parameter is included, along with the parameter value $True.