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

Undoes the domain preparation tasks carried out by the Enable-CsAdDomain cmdlet. This cmdlet is typically used only if you are uninstalling Microsoft Communications Server “14” from a domain.

Syntax

Disable-CsAdDomain [-Confirm [<SwitchParameter>]] [-Domain <Fqdn>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Domain

Optional

String

Fully qualified domain name of the domain where domain preparation should be rolled back (for example, -Domain asia.litwareinc.com). If this parameter is not included, then rollback will take place on the local domain.

DomainController

Optional

String

Enables administrators to specify the fully qualified domain name of the domain controller to be used when running Disable-CsAdDomain. If not specified, the cmdlet will use the first available domain controller.

GlobalCatalog

Optional

String

Fully qualified domain name of a global catalog server in your domain. This parameter is not required if you are running Disable-CsAdDomain 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.

Force

Optional

String

If set to True ($True) then rollback will occur even if Disable-CsAdDomain determines that at least one front end, conferencing, or Web Services server is still activated in the domain. If set to False (the default value), then the command will fail if a front end, conferencing, or Web Services server is still activated in the domain.

Report

Optional

String

Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\DisableDomain.html"

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 in a domain that domain must be correctly prepared; that preparation involves extending the Active Directory schema to allow for the addition of Communications Server-specific attributes (see the help topic Get-CsAdServerSchema) as well as assigning the required Access Control Entries to the universal groups needed for managing and operating 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 domain-level changes. The Disable-CsAdDomain cmdlet provides a way for you to undo all the domain-level modifications made by the Enable-CsAdDomain 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 /domain /action:DomainUnprep

Return Types

Disable-CsAdDomain disables instances of the Microsoft.Rtc.Management.Deployment.LcDomainSettingsState object.

Examples

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

Copy Code
Disable-CsAdDomain

The preceding command rolls back the domain preparation process in the local domain. Because the –Force parameter is not included, the command will fail if Disable-CsAdDomain determines that at least one front end, conferencing, or Web Server server is still active in the domain.

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

Copy Code
Disable-CsAdDomain -Domain asia.litwareinc.com

The preceding command rolls back the domain preparation process for the domain asia.litwareinc.com.

-------------------------- Example 3 ------------------------

Copy Code
Disable-CsAdDomain -Force

The command shown in Example 3 uses the –Force parameter to force the rollback of the domain preparation process in the local domain. This means that rollback will occur even if Disable-CsAdDomain determines that at least one front end, conferencing, or Web Server server is still active in the domain.