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

Modifies the security settings on the universal groups created during forest preparation. These modifications provide the permissions needed to host and manage Microsoft Communications Server 2010 -enabled users within the domain.

Syntax


Enable-CsAdDomain [-Confirm [<SwitchParameter>]] [-CrossForest <SwitchParameter>] [-Domain <Fqdn>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <$true \| $false>] [-WhatIf [<SwitchParameter>]]

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

Parameters

Parameter	Required	Type	Description
Domain	Optional	String	Fully qualified domain name of the domain where domain preparation is to take place (for example, -Domain asia.litwareinc.com). If this parameter is not included, domain preparation 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 Enable-CsAdDomain. If not specified, the cmdlet will use the first available domain controller.
SkipPrepareCheck	Optional	Boolean	If set to True ($True) then Enable-CsAdDomain will skip its initial preparation check.
CrossForest	Optional	Switch Parameter	If present, indicates that domain preparation is taking place in a domain in a different forest. This parameter is not required of the domain being enabled is in the same forest as the computer where the command is being executed.
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-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	Switch Parameter	Suppresses the display of any non-fatal error message that might arise when running the command.
Report	Optional	String	Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\DomainPrep.html"
WhatIf	Optional	SwitchParameter	Describes what would happen if you executed the command without actually executing the command.
Confirm	Optional	SwitchParameter	Prompts you for confirmation before executing the command.

Detailed Description

Before you can 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 to managing and operating Communications Server. Domain preparation is typically carried out through the Communications Server Setup Wizard. However, administrators can also perform domain preparation at any time by running the Enable-CsAdDomain cmdlet. This cmdlet carries out tasks similar to those carried out by the following Office Communications Server 2007 R2 command:

Lcscmd.exe /domain /action:DomainPrep

After Enable-CsAdDomain finishes running, you can use the Get-CsAdDomain cmdlet to verify that the domain is ready for the next step in the installation process.

Return Types

Enable-CsAdDomain enables instances of the Microsoft.Rtc.Management.Deployment.LcDomainSettingsState object.

Examples

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

	Copy Code
Enable-CsAdDomain

The command shown in Example 1 prepares the local domain for the installation of Microsoft Communications Server.

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

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

The preceding command prepares the domain asia.litwarein.com for the installation of Microsoft Communications Server.