Enable-CsAdDomain

 

Topic Last Modified: 2012-03-23

Modifies the security settings on the universal groups created during forest preparation. These modifications provide the permissions needed to host and manage users enabled for Microsoft Lync Server 2010 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>]]

Detailed Description

Before you can install Lync Server 2010 in a domain, that domain must be correctly prepared, a process that includes extending the Active Directory schema to allow for the addition of attributes specific to Lync Server as well as assigning the required Access Control Entries to the universal groups needed for managing and operating Lync Server. Domain preparation is typically carried out through the Lync Server 2010 Setup Wizard. However, administrators can also perform domain preparation by running the Enable-CsAdDomain cmdlet.

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.

Note

If you receive the following error, “Cannot find the object ‘CrossRef’ in Active Directory” while running tasks to prepare a child domain of a single-forest environment with multiple domains, you may have to manually add the RTCComponentUniversalServices group from the parent domain to the Windows Authorization Access group in the child domain.

This cmdlet carries out tasks similar to those carried out by the following Microsoft Office Communications Server 2007 R2 command:

Lcscmd.exe /domain /action:DomainPrep

Who can run this cmdlet: You must be a domain administrator in order to run the Enable-CsAdDomain cmdlet locally.

Parameters

Parameter Required Type Description

Domain

Optional

String

Fully qualified domain name (FQDN) 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 FQDN 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 if the domain being enabled is in the same forest as the computer where the command is being run.

GlobalCatalog

Optional

String

FQDN 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

FQDN of a domain controller where global settings are stored. If global settings are stored in the System container in Active Directory Domain Services (AD DS), 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.

Input Types

None. Enable-CsAdDomain does not accept pipelined input.

Return Types

None.

Example

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

Enable-CsAdDomain

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

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

Enable-CsAdDomain -Domain asia.litwareinc.com

The preceding command prepares the domain asia.litwareinc.com for the installation of Lync Server.

See Also

Other Resources

Disable-CsAdDomain
Get-CsAdDomain