Makes the Active Directory modifications required before you can install Microsoft Communications Server 2010. This includes making global changes to the Configuration or System containers; creating universal groups; and creating Communications Server 2010-specific property sets and display specifiers.
Syntax
Enable-CsAdForest [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-GroupDomain <Fqdn>] [-GroupDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-SkipPrepareCheck <$true | $false>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
GroupDomain |
Optional |
String |
Fully qualified domain name of the domain where the new universal security groups should be created. If this parameter is not included then the groups will be created 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-CsAdForest 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. |
|
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\ForestPrep.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
Before you can install Microsoft Communications Server 2010 you must make a number of forest-level changes to Active Directory. This includes creating Communications Server-specific objects and display specifiers as well creating universal security groups needed to manage Microsoft Communications Server. Forest preparation is typically carried out through the Communications Server Setup Wizard. However, administrators can also perform forest preparation at any time by running the Enable-CsAdForest cmdlet. This cmdlet carries out tasks similar to those carried out by the following Office Communications Server 2007 R2 command:
Lcscmd.exe /forest /action:ForestPrep
After Enable-CsAdForest finishes running, you can use the Get-CsAdForest cmdlet to verify that the forest is ready for the next step in the installation process.
Return Types
Enable-CsAdForest enables instances of the Microsoft.Rtc.Management.Deployment.LcForestSettingsState object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Enable-CsAdForest |
|
Prepares the Active Directory forest for the installation of Microsoft Communications Server. Because the –GroupDomain parameter is not used, the universal security groups created by running Enable-CsAdForest will be created in the local domain.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Enable-CsAdForest -GroupDomain admin.litwareinc.com |
|
Prepares the Active Directory forest for the installation of Microsoft Communications Server. The –GroupDomain parameter is used to ensure that the universal security groups created by running Enable-CsAdForest will be created in the admin.litwareinc.com domain.