Topic Last Modified: 2010-10-01

Returns information about the Microsoft Lync Server 2010 certificates being used on the local computer.


Test-CsCertificateConfiguration [-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\Certificates.html". If this file already exists, it will be overwritten when you run the cmdlet.



Switch Parameter

Reports detailed activity to the screen as the cmdlet runs.

Detailed Description

Test-CsCertificateConfiguration is an example of a "synthetic transaction." Synthetic transactions are used in Lync Server 2010 to verify that users are able to successfully complete common tasks such as logging on to the system, exchanging instant messages, or making calls to a phone located on the public switched telephone network (PSTN). These tests can be conducted manually by an administrator, or they can be automatically run by an application such as Microsoft System Center Operations Manager (formerly Microsoft Operations Manager).

Test-CsCertificateConfiguration returns information about the certificates being used by Lync Server 2010. The Test-CsCertificateConfiguration cmdlet is primarily intended for use by the Certificate wizard. It is recommended that administrators use Get-CsCertificate to retrieve certificate information.

Who can run this cmdlet: To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsCertificateConfiguration"}

Input Types

None. Test-CsCertificateConfiguration does not accept pipelined input.

Return Types

Test-CsCertificateConfiguration returns instances of the Microsoft.Rtc.Management.Deployment,CertificateExists object.


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

Copy Code

The command shown in Example 1 returns information about the certificates that are currently being used (on the local computer) by Lync Server 2010.

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

Copy Code
Test-CsCertificateConfiguration -Report "C:\Logs\Certificates.xml"

The command shown in Example 2 is a variation of the command shown in Example 1. In this case, however, the Report parameter is used to specify a file path (C:\Logs\Certificates.xml) for the output file generated when you run Test-CsCertificateConfiguration.

See Also

Other Resources