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

Returns information indicating whether your Active Directory schema has been correctly configured to allow for the installation of Microsoft Communications Server 2010.


Get-CsAdServerSchema [-Report <String>]


Parameter Required Type Description




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



Switch Parameter

Suppresses the display of any non-fatal error message that might arise when running the command.

Detailed Description

Microsoft Communications Server “14” cannot be installed until your Active Directory schema has been properly extended; that means that Communications Server-specific objects and attributes must be added to Active Directory before installation can take place. For example, user account objects must be modified to allow for attributes that do such things as indicate the voice policy assigned to a user, or report whether a not that account has been enabled for Enterprise Voice.

The Get-CsAdServerSchema cmdlet returns a single value that tells you whether or not Active Directory has been extended and is prepared for the installation of Communications Server. If Get-CsAdForest returns the value SCHEMA_VERSION_STATE_CURRENT that means the schema has been extended. If the cmdlet returns any other value then the schema has not been extended.

Get-CsAdServerSchema runs as part of the Setup Wizard; if the Wizard determines that the schema is not correctly prepared then you will receive an error message and setup will stop. However, you can also run Get-CsAdServerSchema independently of the Setup Wizard, giving you the opportunity to verify the schema status before you try to install Communications Server.

Get-CsAdServerSchema performs the same function as the following Office Communications Server 2007 R2 command: Lcscmd.exe /domain /action:CheckSchemaPrepState.

Return Types

Get-CsAdServerSchema returns instances of the Microsoft.Rtc.Management.Deployment.SchemaVersionState object.


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

Copy Code

The command shown in Example 1 returns the current state of the Active Directory server schema. If the schema is currently up to date, the command returns the following value: SCHEMA_VERSION_STATE_CURRENT.

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

Copy Code
Get-CsAdServerSchema -Report C:\Server_Schema.html

Example 2 also returns the current state of the Active Directory server schema; in addition, the command writes more detailed information about that schema to a file named C:\Server_Schema.html. This detailed information includes such things as the schema major version and minor version.