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

Undoes the forest preparation tasks carried out by the Enable-CsAdForest cmdlet. This cmdlet is typically used only if you are uninstalling Microsoft Communications Server 2010.

Syntax


Disable-CsAdForest [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-GroupDomain <Fqdn>] [-GroupDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Disable-CsAdForest [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-GroupDomain <Fqdn>] [-GroupDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
GroupDomain	Optional	String	Fully qualified domain name of the domain where the Communications Server universal groups were created (for example, -GroupDomain asia.litwareinc.com). If this parameter is not included, Disable-CsAdForest will look for the universal groups in the local domain.
GroupDomainController	Optional	String	Fully qualified domain name of a domain controller where universal group information is stored.
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-CsComputer 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.
RootDomainController	Optional	String	Fully qualified domain name of the root domain controller, computers used to create trust paths for clients that need to access resources in domains other than their own.
Report	Optional	String	Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\DisableForest.xml"
Force	Optional	Switch Parameter	If set to True ($True), forces the rollback of the forest preparation steps even if Disable-CsAdForest detects that at least one of the domains in the forest is still prepared for Communications Server. If set to False (the default value), the command will fail if Disable-CsAdForest detects that at least one of the domains in the forest is still prepared for Communications Server.
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 you install Microsoft Communications Server 2010 you make a number of forest-level changes to Active Directory. These changes (which can be carried out using the Enable-CsAdForest cmdlet) include creating Communications Server-specific objects and display specifiers as well creating universal security groups needed to manage Microsoft Communications Server. If you later decide to uninstall Communications Server (or if you encounter problems during the setup process) you might need to rollback these forest-level changes. The Disable-CsAdForest cmdlet provides a way for you to undo all the forest-level modifications made by the Enable-CsAdForest cmdlet. The tasks carried out by Disable-CsAdForest are very similar to the tasks carried out by the following Office Communications Server 2007 R2 command:

Lcscmd.exe /forest /action:ForestUnprep

Return Types

Disable-CsAdForest disables instances of the Microsoft.Rtc.Management.Deployment.LcForestSettingsState object.

Examples

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

	Copy Code
Disable-CsAdForest

The command shown in Example 1 rolls back the forest preparation tasks carried out by Enable-CsAdForest. Because the –Force parameter is not included, the command will fail if Disable-CsAdForest detects that at least one of the domains in the forest is still prepared for Communications Server.

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

	Copy Code
Disable-CsAdForest -Force

In Example, 2 forest preparation is rolled back even if Disable-CsAdForest detects that at least one of the domains in the forest is still prepared for Communications Server. Rollback is forced by including the –Force parameter.