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

Enables the most-recently published Microsoft Communications Server 2010 topology. After you have made changes to your topology those changes will not take effect until they have been both published and enabled.

Syntax

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

Parameters

Parameter Required Type Description

Fqdn

Optional

String

Fully qualified domain name of the computer where the topology needs to be enabled. For example: -Fqdn "atl-edge-001.litwareinc.com".

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-CsTopology on a computer with an account in your domain.

GlobalSettingsDomainController

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.

SkipPrepareCheck

Optional

Boolean

If set to True ($True) Enable-CsTopology will skip its initial preparation check.

Report

Optional

String

Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\Enable_Topology.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

After you have installed Microsoft Communications Server “14” you will eventually need to make changes to the Communications Server infrastructure; for example, you might need to add a new site, delete an existing Registrar pool, add an additional Archiving Server, and so on. These infrastructure changes must be made using the Communications Server Topology Builder. After you have made the changes in Topology Builder you can then publish and enable those changes using that same tool. These latter two steps are very important: although you can make as many modifications as you want using the Topology Builder, those modifications do not actually take effect, and your Communications Server infrastructure will not actually change, until the modifications have been published and the new topology has been enabled.

When changes are published, the new information (for example, a new site or a new server role) is written to the Central Management Database. However, these new (or the newly-modified) objects do not immediately join your topology; that occurs only when the updated topology has been enabled. If you select the Publish option in Topology Builder both of these steps will take place: the changes will be published (written the Central Management Database) and the new topology will be enabled.

There might be times, however, when you would prefer to publish your changes and enable your topology as separate steps; doing so gives you an opportunity to confirm that deployment has succeeded before you bring the new objects into the topology. To separately publish and then enable topology changes, you must do the following:

In Topology Builder, save the modified topology as an XML file (using the Save As option).

Use the cmdlet Publish-CsTopology to publish that XML file. Publishing the XML file writes the changes to the Central Management Database.

Use the cmdlet Enable-CsTopology to cause the published changes to take effect.

Return Types

Enable-CsTopology enables instances of the Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology object.

Examples

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

Copy Code
Enable-CsTopology

The command shown in Example 1 enables the most-recently published topology.

-------------------------- Example 2 ------------------------

Copy Code
Enable-CsTopology -Fqdn "atl-edge-001.litwareinc.com"

In Example 2, the topology is enabled on a specified computer: atl-edge-001.litwareinc.com.