Topic Last Modified: 2010-10-01

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


Get-CsAdServerSchema [-Report <String>]


Parameter Required Type Description



Switch Parameter

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




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

Detailed Description

Lync Server 2010 cannot be installed until your Active Directory schema has been properly extended; that means that objects and attributes specific to Lync Server must be added to Active Directory Domain Services (AD DS) 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 or 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 Lync Server. If Get-CsAdServerSchema returns the value SCHEMA_VERSION_STATE_CURRENT, the schema has been extended. If the cmdlet returns any other value, then the schema has not been extended.

Get-CsAdServerSchema typically runs as part of the Setup Wizard; if Setup determines that the schema is not correctly prepared, 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 Lync Server.

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

Who can run this cmdlet: By default, any user who has read permissions to Active Directory can run the Get-CsAdServerSchema cmdlet locally. Typically all domain members have this permission.

Input Types

None. Get-CsAdServerSchema does not accept pipelined input.

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 up to date, the command returns the following value: SCHEMA_VERSION_STATE_CURRENT.

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

Copy Code
Get-CsAdServerSchema -Report C:\Logs\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:\Logs\Server_Schema.html. This information includes details such as the schema major version and minor version.

See Also

Other Resources