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.